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Chapter 1 

Configuring Objects/Resources 


There are numerous objects, also called resources, that the user can create and configure in GMAT. Examples include 
Spacecraft, Propagators, Coordinate Systems, and Plots. Each of these resources are configurable from the script 
and GUI and this chapter discusses how to configure all objects regardless of your chosen interface. 

Each section in this Chapter is devoted to a specific type of object. For each object, we present a screen capture 
of the dialogue box used to configure the object from the GUI. Next we present a short explanation of how to use 
the dialogue box to configure common types. Finally, a table is presented that describes in detail each setable field 
for the object. The detail includes default values, allowable inputs and ranges, and a text description of the field. 

Let’s begin by looking at the Spacecraft object. 
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Figure 1.1: Spacecraft Dialogue Box / Orbit Tab 
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CHAPTER 1. CONFIGURING OBJECTS/RESOURCES 

1.0.1 Overview of the Spacecraft Object 

The Spacecraft object is one of the most important resources in GMAT and can be configured in numerous ways. 
For most mission applications, GMAT’s primary use and function is to simulate and model how an actual spacecraft 
would behave (or behaved) in a flight situation. You do this by creating and configuring spacecraft objects, GMAT’s 
mathematical model of real-world spacecraft, and by issuing commands such as Propagate for GMAT to apply to 
the spacecraft model. 

The types of parameters and settings on the Spacecraft Object fall into several categoris: Orbit, Attitude, 
Ballistic/Mass, Sensors, Tanks, and Actuators. Each of these is configured on a separate tab on the Spacecraft 
dialog box. For example, you can configure the initial state and epoch on the Orbit tab, and the , the mass and 
ballistic properties on the Ballistic/Mass tab. In the following sections we discuss each tab in detail. 

Possible Coupling with Other Objects 

A Spacecraft Requires Other Objects/ Commands of Type: None. 

A Spacecraft has the Potential to Couple with Objects/ Commands of Type: Tank, Thruster, Differential Corrector, 
fminconOptimizer, XYPlot, OpenGLPlot, ReportFile, Variables/ Arrays, Coordinate System, MATLAB Function, 
BeginFiniteBurn, EndFiniteBurn, Function Call, Assignment Command, Maneuver, Propagate, Report, Save, Script 
Event, If, For, While, Vary, Achieve, Minimize, NonlinearConstraint. 


1.0.2 Spacecraft Orbit Tab 

The Spacecraft/ Orbit tab is used to set the orbit state and epoch and is illustrated in Fig. 2.1. On this tab, you can 
choose the epoch, coordinate system, and the state representation in which to enter initial condition information. 
Their are three groups on the Spacecraft/Orbit tab: Epoch, State Configuration, and State Vector. Below, we discuss 
each group in detail. 


Epoch Group 

The Epoch group allows you to select the time system and time format in which to enter the initial Space- 
craft epoch. Several choices are available including A IMod Julian, TAIModJulian, UTCModJulian, TTModJulian, 
AlGregorian, TAIGregorian, UTCGregorian, TTGregorian . An epoch can be provided in either the Modified Ju- 
lian Date (with reference epoch 05 Jan 1941 12:00:00.000 TAI) or Gregorian Date formats. As an example, the J2000 
Epoch should be expressed using the Gregorian date format as 01 Jan 2000 12:00.000 (TDB). 

Note that if you change the EpochFormat combo box, and have defined the spacecraft state with respect to a 
time dependent coordinate system, the state vector representation in the GUI does not change. For example, if you 
define a Spacecraft’s state with respect to the Earth Fixed system, and then change the epoch, you have not changed 
the state vector in the Earth Fixed system and therefore the values in the GUI do not change. However, change the 
epoch does change the inertial state that results from converting the Earth Fixed state to the inertial state. This 
is because the orientation of the Earth Fixed frame is different at the new epoch, and so the transformation to the 
inertial frame yields a new results. 


State Configuration Group 

The State Configuration group allows the user to select the coordinate system and state representation for a 
Spacecraft’s initial conditions. The StateType pull-down menu contains several options for the orbit state Represen- 
tation including Cartesian, Keplerian, Modif iedKeplerian, SphericalAZFPA, SphericalRADEC, Equinoctial . 
The Coordinate System pull-down menu allows you to specify the Coordinate System in which the Spacecraft’s ini- 
tial conditions are expressed. The default coordinate systems always appear and are EarthMJ2000Eq,EarthMJ000Ec, 
and EarthFixed. If you create other user defined Coordinate Systems, they also appear in the Coordinate System 
drop-down menu. The numeric values contained in the State Vector group are dynamically updated as changes are 
made to State Type and Coordinate System. For example, if you enter a state vector in EarthMJ2000Eq, hit 
apply, and change the Coordinate System pull-down to Earth Fixed, the GUI will reconfigure to show the equivalent 
state vector in the Earth Fixed system at the defined epoch. 
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State Vector Group 

The State Vector group contains the numeric values for a Spacecraft’s initial conditions. The state vector is 
shown in the selected state representation as defined in State Type and is expressed in the requested coordinate 
system defined by Coordinate System. The labels, units, and numeric values dynamically respond to changes in 
either the Coordinate System or State Type pull-down menus. You can use the State Vector to group to define a 
spacecraft’s initial conditions in any coordinate system, or to view the spacecraft’s state in any coordinate system. 

A detailed discussion of all fields on the Spacecraft Orbit tab is found in Table 2.1. Now let’s look at the Spacecraft 
Attitude tab. 


1.0.3 Spacecraft Attitude Tab 

This Tab is not currently supported in GMAT. It is included only to illustrate look-and-feel of future enhancements. 


1.0.4 Spacecraft Ballistic/Mass Tab 

The Ballistic/Mass tab, shown in Fig. 2.2is used to set spacecraft mass and ballistic properties. On this panel, 
you can set properties such as DryMass, DragArea, and SRPArea among others. GMAT currently only supports a 
point-mass spacecraft model. In the future GMAT will support a higher fidelity spacecraft model, and this panel 
will allow you to set the spacecraft moments of inertia and other properties. 
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Figure 1.2: Spacecraft Dialogue Box / Ballistic /Mass Tab 


Ballistics Group 

The Ballistics group allows the user to specify spacecraft physical properties that are used to calculate properties 
such as the ballistic coefficient. A detailed discussion of all fields on the Spacecraft Ballistic/Mass tab is found in 
Table 2.3. Now let’s look at the Sensors tab. 
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1.0.5 Spacecraft Sensors Tab 


This Tab is not currently supported in GMAT. 


1.0.6 Spacecraft Tanks Tab 

The Spacecraft/Tanks tab allows you to add multiple tanks to a spacecraft. Tanks are created separately from 
spacecraft and if you have not created any tanks, the Available Tanks list will appear empty. You can add an 
existing tank to a spacecraft by selecting the desired tank using a left mouse click and then using a left mouse click 
on the right-arrow icon. If there are no existing tanks, go to the resource tree, right click on the Hardware folder 
that appears as a subfolder to spacecraft, and select Add/Fuel Tank. 



Figure 1.3: Spacecraft Dialogue Box / Tanks Tab 


1.0.7 Spacecraft Actuators Tab 


The spacecraft /Actuators tab allows you to add multiple actuators to a spacecraft. Currently the only actuator that 
GMAT supports are thrusters. You must create a thruster before you can add it to a spacecraft. If you have not 
created any thrusters, the Available Thrusters list will appear empty. You can add existing thrusters to a spacecraft 
by selecting the desired thruster using a left mouse click and then using a left mouse click on the right- arrow icon. 
To create a Thruster, go to the resource tree, right click on the Hardware folder that appears as a subfolder to 
spacecraft, and select Add/Thruster. 
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Figure 1.4: Spacecraft Dialogue Box / Actuators Tab 


Table 1.1: Fields Associated with a Spacecraft Orbit State 
(Orbit Tab) 


Field 

Options and Description 

StateType 

Default: Cartesian. Options: [Cartesian, Keplerian, 

Modif iedKeplerian, SphericalAZFPA, SphericalRADEC, Equinoctial ]. 
The StateType field allows the user to configure the type of state vector 
that they wish to use. The Statetype field has a dependency upon the 
CoordinateSystem field. If the Coordinate System chosen by the user 
does not have a gravitational body at the origin, then the state types 
Keplerian, Modif iedKeplerian, and Equinoctial are not permitted. 
This is because these state types require a /i value. Units: N/ A. When the 
Keplerian or Modif iedKeplerian state types are selected, the Anomaly 
Type field becomes visible. 

Coordinate System 

Default: EarthMJ2000Eq. Options: [ EarthMJ2000Eq, EarthMJ2000Ec, 

EarthFixed, or any user defined system]: The Coordinate System field 
allows the user to choose which coordinate system with which to define the 
orbit state vector. The CoordinateSystem field has a dependency upon 
the StateType field. If the Coordinate System chosen by the user does not 
have a gravitational body at the origin, then the state types Keplerian, 
Modif iedKeplerian, and Equinoctial are not permitted. This is because 
these state types require a /i value. Units: N/A. 
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Table 1.1: (Fields Associated with a Spacecraft Orbit State 
(Orbit Tab), continued) 


Field 

Options and Description 

EpochFormat 

Default: TAIModJulian. Options: [A IMod Julian, TAIModJulian, 

UTCModJulian, TTModJulian, AlGregorian, TAIGregorian, 

UTCGregorian, TTGregorian ]: The DateFormat field allows the user to 
specify the format for defining a spacecraft’s initial epoch. DateFormat 
determines both the time system (TAI, TT, etc) and the time format 
(MJD or Gregorian). Units: N/A. 

Epoch 

Default: 21545.000000000. Options: [See Comments]: The Epoch field 
allows the user to specify the initial spacecraft epoch. The format of the 
epoch must be consistent with the DateFormat field. If DateFormat is of the 
“MJD” type, then the epoch is in Modified Julian format. If DateFormat 
is a “Gregorian Type”, the format is similar to 01 Jan 2000 12:00:00.000. 
Units: MJD - days, Gregorian - N/A. 

AnomalyType 

Default: TA. Options: [ TA, MA, EA, HA]: The Epoch field allows the 

user to specify the to select the AnomalyType needed for the Kepler i an 
or Modif iedKeplerian spacecraft state. In the scripting environment, 
AnomalyType is not used. Units: N/A. 


Fields associated with Cartesian state. 

X 

Default: 7100. Options: [ Real Number ]: X is the x-component of 

the Spacecraft state in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km. 

Y 

Default: 0. Options: [ Real Number ]: Y is the y-component of 

the Spacecraft state in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km. 

Z 

Default: 1300. Options: [ Real Number ]: Z is the z-component of 

the Spacecraft state in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km. 

VX 

Default: 0. Options: [ Real Number ]: VX is the x-component of the 
Spacecraft velocity in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km/sec. 

VY 

Default: 7.35. Options: [ Real Number ]: VY is the y-component of 

the Spacecraft velocity in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km/sec. 

VZ 

Default: 1.0. Options: [ Real Number ]: VZ is the z-component of 

the Spacecraft velocity in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km/sec. 


NOTE: Default values for the remaining state types are obtained through 
transformations of the default Cartesian spacecraft state values. The 
Keplerian, Modif iedKeplerian, and Equinoctial are dependant on the 
origin of the CoordinateSystem, because the state types require a /i value. 
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Table 1.1: (Fields Associated with a Spacecraft Orbit State 
(Orbit Tab), continued) 


Field 

Options and Description 


Fields associated with Keplerian state. 

SMA 

Default: 7191.938817629. Options: [Real Number ^ 0 ]: The SMA field 
is the spacecraft orbit’s osculating Keplerian semimajor axis in coordinate 
system chosen in the Spacecraft CoordinateSystem field. SMA must be 
strictly greater than or less than zero. For circular and elliptical (0 < ECC 
< 1) orbits SMA should only be a positive Real Number and for hyperbolic 
orbits (ECC >1) SMA should only be a negative Real Number. GMAT 
does not support the creation of parabolic orbits. Units: km. 

ECC 

Default: 0.024549749. Options: [ 0 < Real Number, ECC^ 1 ]: The ECC 
field is the spacecraft orbit’s osculating eccentricity. ECC must be greater 
than or equal to zero but not equal to one (GMAT does not support 
parabolic orbits). Note: ECC can be greater thanone. See the SMA de- 
scription for additional restrictions to the allowable values of ECC. Units: 
Dimensionless. 

INC 

Default: 12.850080057. Options: [Real Number]: The INC field is the 
spacecraft orbit’s osculating inclination, in degrees, w/r/t to the selected 
coordinate system. Units: degrees. 

AOP 

Default: 314.190551536. Options: [Real Number] :The AOP field is the 
spacecraft orbit’s osculating argument of periapsis, in degrees, w/r/t to the 
selected coordinate system. Units: degrees. 

RAAN 

Default: 306.614802195. Options: [Real Number]: The RAAN field is 
the spacecraft orbit’s osculating right ascension of the ascending node, in 
degrees, w/r/t to the selected coordinate system. Units: degrees. 

TA 

Default: 99.887749332. Options: [Real Number] : The TA field is the space- 
craft orbit’s osculating true anomaly. Units: degrees. 

MA 

Default: 97.107826639. Options: [Real Number]: The MA field is the 
spacecraft orbit’s osculating mean anomaly. Units: degrees. 

EA 

Default: 98.498977103. Options: [Real Number] : The EA field is the space- 
craft orbit’s osculating eccentric anomaly. Units: degrees. 

HA 

Default: 0.000000000. Options: [Real Number]: The HA field is the space- 
craft orbit’s osculating hyperbolic anomaly. Units: degrees. 

Fields associated with Modif iedKeplerian state. 

RadApo 

Default: 7015.378524789. Options: [Real Number ^ 0 ]: The RadApo field 
is the spacecraft orbit’s osculating radius of apoapsis. RadApo must be 
strictly greater than or less than zero. When RadApo is negative, the orbit 
is hyperbolic. Units: km. 
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CHAPTER 1. CONFl'dXJRING OBJECTS /RESOURCES 

Table 1.1: (Fields Associated with a Spacecraft Orbit State 
(Orbit Tab), continued) 


Options and Description 

Default: 7368.4991104681 Options: [Real Number > 0 ]: The RadPer field 
is the spacecraft orbit’s osculating radius of periapsis. RadPer must be 
greater than zero. Units: km. 

See the Kepler i an state section for a description on this field. 

See the Kepler i an state section for a description on this field. 

See the Kepler i an state section for a description on this field. 

See the Kepler i an state section for a description on this field. 

See the Kepler i an state section for a description on this field. 

See the Keplerian state section for a description on this field. 

See the Keplerian state section for a description on this field. 


Fields associated with SphericalAZFPA state. 

RMAG Default: 7218.03297304. Options: [Real Number > 0]: The RMAG field 

allows the user to set the magnitude of the spacecrafts position vector. 
Units: km. 

RA Default: 0. Options: [Real Number]: The RA field allows the user to set 

the spacecraft’s right ascension. Units: degrees. 

DEC Default: 10.3758449200. Options: [Real Number]: The DEC field allows the 

user to set the spacecraft’s declination. Units: degrees. 

VMAG Default: 7.41771528167. Options: [Real Number > 0]: The VMAG field 

allows the user to set the magnitude of the spacecraft’s velocity. Units: 
km/sec. 

AZI Default: 82.377421681. Options: [Real Number]: The AZI field allows the 

user to set the spacecraft’s azimuth angle. Units: degrees. 

FPA Default: 88.60870365370. Options: [Real Number]: The FPA allows the 

user to set a spacecraft’s flight path angle. Units: degrees. 


Fields associated with SphericalRADEC state. 

RMAG See the SphericalAZFPA state section for a description on this field. 

RA See the SphericalAZFPA state section for a description on this field. 

DEC See the SphericalAZFPA state section for a description on this field. 

VMAG See the SphericalAZFPA state section for a description on this field. 



Table 1.1: (Fields Associated with a Spacecraft Orbit State 
(Orbit Tab), continued) 


Field 

Options and Description 

RAV 

Default: 90. Options: [Real Number]: The RAV field i allows the user to set 
the right ascension of the spacecraft’s velocity. Units: degrees. 

DECV 

Default: 7.7477720361. Options: [Real Number]: The DECV field allows the 
user to set the declination of the spacecraft’s velocity. Units: degrees. 

Fields associated with Equinoctial elements. 

SMA 

See the Kepler i an state section for a description on this field. 

h 

Default: -0.024234314. Options: [Real Number]: The h field is the projec- 
tion of the eccentricity vector onto the y ep axes. The T ep system is a system 
used in calculating the equinoctial elements and is beyond the scope of this 
discussion. The GMAT Mathematical Specifications document discusses 
T ep and the calculation of the equinoctial elements in detail. Units: None. 

k 

Default: -0.003922779. Options: [Real Number]: The k field is the projec- 
tion of the eccentricity vector onto the x ep axes. The T ep system is a system 
used in calculating the equinoctial elements and is beyond the scope of this 
discussion. The GMAT Mathematical Specifications document discusses 
T ev and the calculation of the equinoctial elements in detail. Units: None. 

P 

Default: -0.090388347. Options: [Real Number]: The p field is the projec- 
tion of the N vector onto the y ep axes. The N vector and the T ep system 
are used in calculating the equinoctial elements and are beyond the scope 
of this discussion. The GMAT Mathematical Specifications document dis- 
cusses N and T ep and the calculation of the equinoctial elements in detail. 
Units: None. 

q 

Default: 0.067164549. Options: [Real Number]: The q field is the projec- 
tion of the N vector onto the x ep axes. The N vector and the T ep system 
are used in calculating the equinoctial elements and are beyond the scope 
of this discussion. The GMAT Mathematical Specifications document dis- 
cusses N and T ep and the calculation of the equinoctial elements in detail. 
Units: None. 

MeanLongitude 

Default: 3.16359946. Options: [Real Number]: The MeanLongitude field 
is the the spacecraft’s mean longitude. The GMAT Mathematical Spec- 
ifications document discusses mean longitude and the calculation of the 
equinoctial elements in detail. Units: degrees. 
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CHAPTER 1. CONFIGURING OBJECTS/RESOURCES 

Table 1.2: Fields Associated with Spacecraft Physical Properties 
(Ballistic/Mass Tab) 


Field 

Options and Description 

Dry Mass 

Default: 850. Options: [Real Number > 0]: The DryMass field allows the 
user to specify the mass of the spacecraft structure, but does not include 
the mass of tanks, thrusters, or fuel. Units: kg. 

Cd 

Default: 2.2. Options: [Real Number > 0]: The Cd field allows the user to 
specify the spacecraft’s drag coefficient. Units: None. 

Cr 

Default: 1.8. Options: [Real Number >0]: The Cr field allows the user to 
specify the spacecraft’s coefficient of reflectivity. Units: None. 

DragArea 

Default: 15. Options: [Real Number > 0]: The DragArea is the effective 
spacecraft area used in calculate the force due to drag. Units: m 2 . 

SRPArea 

Default: 1. Options: [Real Number > 0]: The SRPArea is the effective 
spacecraft area used in calculate the force due to solar radiation pressures. 
Units: m 2 . 


Table 1.3: Fields Associated with a Spacecraft Ballistic and Mass 
Properties 

Field 

Options and Description 

Cd 

Default: 2.2. Options: [Real Number >0]: Cd is the spacecraft’s drag 
coefficient. Cd must be greater than 0. Units: Dimensionless. 

Cr 

Default: 2.2. Options: [0 < Real Number < 2.0]: Cr is the spacecraft’s 
coefficient of reflectivity. Cr must be greater than 0. Units: Dimensionless. 

DragArea 

Default: 15.0. Options: [Real Number > 0]: The DragArea is the area of 
the spacecraft that is used in calculating atmospheric drag. DragArea must 
be greater than 0. Units: m 2 

SRPArea 

Default: 1.0. Options: [Real Number > 0]: The SRPArea is the area of 
the spacecraft that is used in calculating the force due to solar radiation 
pressure. SRPArea must be greater than 0. Units: m 2 

DryMass 

Default: 850.0. Options: [Real Number > 0]: The DryMass is the mass of 
the spacecraft without the mass of tanks and fuel. DryMass must be greater 
than 0. Units: kg 


1.0.8 Overview of the Propagator Object 

In GMAT, a Propagator is a combination of an integrator and a force model. Hence, a Propagator contains a 
physical model of the space environment that is used to model the motion of a spacecraft as it moves forwards 
or backwards in time (VOP formulation is not currently supported). You configure a Propagator by selecting 
among different numerical integrators and environment models to create a Propagator appropriate to the flight 



Figure 1.5: Propagator Dialogue Box 


regime of spacecraft your mission. GMAT supports the following various numerical integrators: RungeKutta89, 
RungeKutta68, RungeKutta56, PrinceDormand45, PrinceDormand78, BulirschStoer, AdamsBashf orthMoulton. 
Force models supported by GMAT include point mass and non-spherical gravity, atmospheric drag (Earth), and 
solar radiation pressure 

To propagate spacecraft in GMAT, you first create and configure a Propagator object in the script or in the 
Resource Tree. Then, in the mission sequence, you create a Propagate Event, the topic of Chapter ??, and select 
among previously existing Propagators and Spacecraft. Hence, a Propagator is different from a Propagate Event: A 
Propagator is a resource and is found in the GUI under the resource tree, a Propagate Event is configured under the 
Mission Tree and is how you instruct GMAT to propagate spacecraft. 

The Propagator dialogue box is illustrated in Fig. 1.5 and contains two group boxes: the Integrator group and 
the Force Model group. In this Chapter, we discuss the items in each group on the Propagate Panel. We present 
how to configure a propagator and discuss all possible user settable fields in detail. 

Possible Coupling with Other Objects 

A Propagator Requires Other Objects/ Commands of Type: Force Model (Script Only). (Note: There are slight 
differences in how you configure a Propagator in the script and GUI and we refer you to the script example shown 
in the next section for details. Effort has been made to reduce any difference between the script and GUI. Future 
versions of GMAT will address this problem with the Propagator object. 

A Propagator has the Potential to Couple with Objects/ Commands of Type: Propagate. 

1.0.9 Features of the Propagator Dialog Box 

The Propagator Dialogue Box contains two groups boxes: Integrator and Force Model. You select and configure a 
numerical integrator using the Integrator group and a Force Model in the Force Model group. Let’s begin by looking 
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at the Integrator group. 

Integrator Group 

The Integrator group allows you to select and configure a numerical integrator appropriate to your application. 
You select the type of numerical integrator in the Type pull-down menu. After selecting the integrator type, the 
fields below the Type pull-down menu dynamically configure to allow you to set relevant parameters for the selected 
integrator type. All integrators except for Adams-Bashforth-Moulton (ABM) are configured using the same fields. 
The ABM integrator has the following additional fields: MinlntegrationError and NomlntegrationError 

Table 2.8 contains a detailed discussion of each user-settable field for a numerical integrator. 

Force Model Group 

The Force Model group allows you to configure a force model appropriate to the flight regime of your application. 
The central body of propagation and error control method are also defined here. On a Propagator, GMAT classifies 
all celestial bodies into two mutually exclusive categories: Primary Bodies, and Point Masses. Primary bodies can 
have a complex force model that includes non-spherical gravity, drag, and solar radiation pressure. Point mass bodies 
only have a spherical point-mass gravitational force. 

While the Propagate dialogue box is designed to support multiple primary bodies, GMAT currently only supports 
a single primary body per propagator. You can add a Primary Body by clicking the Select button in the Primary 
Bodies group box. Once you have added a Primary Body (or mulitiple bodies in future versions), the pull down 
menu allows you to configure the force model for each Primary Body. The text box, next to the Select button 
contains a list of all Primary Bodies so you can see which bodies are being treated with complex force models. In 
future versions, GMAT will support multiple primary bodies on a propagator allowing you to use a non-spherical 
gravity model for the Earth and Moon simultaneously. 

Configuring certain fields in the Force Model group affects the availability of other fields. For example, if you 
remove all bodies from the Primary Bodies list, the Gravity Field, Atmosphere Model, and Magnetic Field groups 
are disabled. Similarly, in the Gravity Field group, the search button and the Model File field are only active if 
“Other” is selected in the Type pull-down. In the Atmosphere Model group, the SetUp button is only active when 
MSISE-90 or Jachhia-Roberts are selected in the Type pull-down 

GMAT allows you to define Solar flux properties if you select either the MSISE-90 or Jachhia-Roberts atmosphere 
models. By selecting one of these models in the Type pull-down menu in the Atmosphere Model group, the Setup 
button is enabled. Clicking on the Setup button brings up the panel illustrated in Fig. 1.6. Here you can input Solar 
flux values. GMAT does not currently support flux files though future versions will. 

Table 2.7 contains a detailed discussion of each user-settable fields for a force model. 


1.0.10 Fields Associated with a ForceModel 

Table 1.4: Fields Associated with a Force Model 


Field Options and Description 

CentralBody Default: Earth. Options: [ Sun, Mercury, Venus, Earth, Luna, 

Mars, Jupiter, Saturn, Uranus, Neptune, Pluto ]: The Cen- 

tralBody field allows the user to select the origin for the propaga- 
tion. All propagation occurs in the FK5 axes system, about the 
CentralBody chosen by the user. The CentralBody must be a grav- 
itational body and so cannot be a LibrationPoint or other special 
point. Units: N/A. 
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Table 1.4: (Fields Associated with a Force Mo del... continued) 

Options and Description 

Default: {Earth.}. Options: [ Sun, Mercury, Venus, Earth., Luna, 
Mars, Jupiter, Saturn, Uranus, Neptune, Pluto ]: The Pri- 

maryBodies field is a list of all celestial bodies that are to be 
modelled with a force model more complex than point mass grav- 
ity. Lists are surrounded by curly braces. For each PrimaryBody, 
the user can choose a drag, magnetic field, and aspherical gravity 
model. There is a coupling between the PrimaryBodies filed and 
the PointMasses field. A primary body can be any planet or moon 
not included in the PointMasses field. Units: N/A. 

Gravity. PrimaryB ody. PotentialFiie Default: JGM2. Options: [ Central Body-based models, Other. See 

Comments ]. This field allows the user to define the source for the 
non-spherical gravity coefficients for a primary body. If a grav- 
ity file is located in the Primary Body’s potential path as defined 
in the startup file, you only need to specify the model name and 
not the entire path. For example, if the JGM2 coefficients file is 
contained in the directory defined in the startup file by the line 
EARTH_POT_PATH, then you only need to specify the model 
name JGM2. If the model is not contained in the body’s poten- 
tial path, you must supply the entire path as well as the file name. 
If GMAT does not successfully find the file requested, it uses the 
default gravity model as defined in the startup file. From the GUI, 
only models for Earth appear if Earth is the active primary body. 
This is to avoid allowing the user to select a lunar potential model 
for the Earth. If the Other option is selected the user has the abil- 
ity of selecting a gravity model file on their local computer. Units: 
None. 

Gravity. Primary Body. Degree Default: 4. Options: [ Integer >0 and < the maximum specified by 

the model, Order < Degree ]. This field allows the user to select the 
the degree, or number of zonal terms, in the non-spherical gravity 
model. Ex. Gravity .Earth. Degree = 2 tells GMAT to use only 
the J2 zonal term for the Earth. The value for Degree must be less 
than the maximum degree specified by the Model. Units: None. 

Gravity. Primary Body. Order Default: 4. Options: [ Integer >0 and < the maximum specified by 

the model, Order < Degree ]. This field allows the user to select 
the the order, or number of tesseral terms, in the non-spherical 
gravity model. Ex. Gravity.Earth. Order = 2 tells GMAT to use 
2 tesseral terms. Note: Order must be greater than or equal to 
Degree. Units: None. 

Drag Default: None. Options: [None, JachhiaRoberts, MSISE90, 

Exponential ]. The Drag field allows a user to specify a drag 
model. Currently, only one drag model can be chosen for a partic- 
ular propagator and only Earth models are available. Units: N/A. 
Note: This field will be deprecated in future versions of GMAT. 
Currently , the Drag field and the Drag. AtmosphereModel field 
must be set to the same value. 


Field 

PrimaryBodies 
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Table 1.4: (Fields Associated with a Force Model... continued) 


Field 

Drag . AtmosphereModel 


Drag. FI 07 


Drag.F107A 


Drag . Magnet i c Index 


SRP 


PointMasses 


ErrorControl 


Options and Description 

Default: None. Options: [JachhiaRoberts, MSISE90, 

Exponential ]. The Drag. At mo sphere Mo del field allows a user 
to specify a drag model. Currently, only one drag model can be 
chosen for a particular propagator and only Earth models are avail- 
able. Units: N/A. 

Default: 150. Options: [ Real Number > 0 ]. The F107 field allows 
you to set the F\ 0 .7 solar flux value used in computing atmospheric 
density. F 10.7 is the solar radiation at a wavelength of 10.7 cm. 
Units: W/m 2 / Hz 

Default: 150. Options: [ Real Number > 0 ]. The F107A field 
allows you to set the average F 10.7 value. F 10.7 is the average of 
F 10.7 over one month. Units: W/m 2 /Hz 

Default :3. Options: [ 0 < Real Number < 9 ]:'The Magneticlndex 
index field allows you to set the k p value for use in atmospheric 
density calculations. k p is a planetary 3-hour- average, geomagnetic 
index that measures magnetic effects of solar radiation. Units: 
None. 

Default: Off. Options: [ On, Off ]. The SRP field allows the user to 
include the force due to solar radiation pressure in the total sum 
of forces. Units: N/A. 

Default: None. Options [ Sun, Mercury, Venus, Earth, Luna, Mars, 
Jupiter, Saturn, Uranus, Neptune, Pluto ]. A PointMass is a 
planet or moon that is modelled by a point source located at its 
center of gravity. A PointMass body can be any planet or moon 
not included in the PrimaryBodies field. Units: N/A. 

Default: RSSStep. Options: [ RSSStep, RSSState, LargestState, 
LargestStep]: The ErrorControl field allows you to choose how 
a Propagator measures the error in an integration step. The algo- 
rithm selected in the ErrorControl field is used to determine the 
error in the current step, and this error is compared to the value 
set in the Accuracy field to determine if the step has an accept- 
able error or needs to be improved. All error measurements are 
relative error, however, the reference for the relative error changes 
depending upon the selection of ErrorControl. RSSState is the 
Root Sum Square (RSS) relative error measured with respect to 
the current step. RSSState is the (RSS) relative error measured 
with respect to the current state. LargestStep is the state vector 
component with the largest relative error measured with respect 
to the current step. LargestState is the state vector component 
with the largest relative error measured with respect to the current 
state. For a more detailed discussion see the GMAT Mathematical 
Specification. Units: N/A. 


1.0.11 Fields Associated with an Integrator 
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Table 1 .5: Fiel<is Associated with an Integrator 

Field Options and Description 

Fields associated with All Integrators 

Type Default: RungeKutta89. Options: [ RungeKutta89, RungeKutta68, 

RungeKutta56, PrinceDormand45, PrinceDormand78, BulirschStoer, 
AdamsBashforthMoulton ]: The Type field is used to set the type of 

numerical integrator. Units: N/A. 

InitialStepSize Default: 60 (sec). Options: [ Real Number ]. The InitialStepSize is 

the size of the first attempted step by the integrator. If the step defined by 
InitialStepSize does not satisfy Accuracy, the integrator adapts the step 
according an algorithm defined in the mathematical specifications document to 
find an acceptable first step that meets the user’s requested Accuracy. Units: 
sec. 

Accuracy Default: le-11. Options: [ Real Number > 0 ]. The Accuracy field is used 

to set the desired accuracy for an integration step. Units: N/A. When you 
set a value for Accuracy, GMAT uses the method selected in ErrorControl 
field on the Force Model, to determine a metric of the accuracy. For each step, 
the integrator ensures that the accuracy, as calculate using the method define 
by ErrorControl, is less than the limit defined by Accuracy. If an integrator 
exceeds MaxStep At tempts trying to meet the requested accuracy, and error 
message is thrown and propagation stops. 

MinStep Default: .001 (sec). Options: [ Real Number > 0, MinSt ep < MaxStep ]. The 

MinSt ep field is used to set the minimum allowable step size. Units: sec. 

MaxStep Default: 2700.0 (sec.). Options: [ Real Number > 0, MinStep < MaxStep ]. 

The MaxStep field is used to set the maximum allowable step size. Units: sec. 

MaxStep At tempts Default: 50. Options: [ Integer > 0]. The MaxStep At tempts field allows the 

user to set the number of attempts the integrator takes to meet the tolerance 
defined by Accuracy. Units: None. 


Fields associated only with Adams-Bashforth-Moulton Integrator 


MinlntegrationError Default: 1.0e-13. Options: [ Real Number > 0, MinlntegrationError < 

Nomint egr at ionErr or < Accuracy ]: The MinlntegrationError field is used 
by the ABM integrator (and other predictor-corrector integrators when imple- 
mented) as the desired integration error to be obtained when the step size is 
changed. Predictor-Corrector integrators adapt step size when the obtained in- 
tegration error falls outside of the range of acceptable steps, as determined by 
the bounds set by the MinlntegrationError and Accuracy fields. The integra- 
tor then applies an internal calculation to recompute the step size, attempting 
to hit the Nomint egr at ionErr or, and restarts the integrator. Units: N/A. 
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Table 1.5: Fields Associated with an Integrator.... (continued) 


Field Options and Description 

NomlntegrationError Default: 1.0e-ll. Options: [ Real Number > 0, MinlntegrationError < 

NomlntegrationError < Accuracy ]: The NomlntegrationError field is used 
by the ABM integrator (and other predictor-corrector integrators when imple- 
mented) as the desired integration error to be obtained when the step size is 
changed. Predictor-Corrector integrators adapt step size when the obtained in- 
tegration error falls outside of the range of acceptable steps, as determined by 
the boimds set by the MinlntegrationError and Accuracy fields. The integra- 
tor then applies an internal calculation to recompute the step size, attempting 
to hit the NomlntegrationError, and restarts the integrator. Units: N/A. 


Script Examples 


Create ForceModel MyProp_ForceModel ; 

GMAT MyProp_ForceModel . CentralBody = Earth; 

GMAT MyProp_ForceModel.PrimaryBodies = {Earth}; 

GMAT MyProp_ForceModel .PointMasses = {Sun, Luna}; 

GMAT MyProp_ForceModel .Drag = None; 

GMAT MyProp.ForceModel . SRP = Off; 

GMAT MyProp_ForceModel.ErrorControl = RSSStep; 

GMAT MyProp_ForceModel. Gravity .Earth. Degree = 4; 

GMAT My Prop_ForceModel .Gravity .Earth. Order = 4; 

GMAT MyPr op_ForceModel. Gravity .Earth. Potent ialFile =/JGM2v; 

Create Propagator MyProp; 

GMAT MyProp. FM = MyProp_ForceModel ; 

GMAT MyProp. Type = RungeKutta89 ; 

GMAT My Pr op. Initial St epSize = 60; 

GMAT My Prop. Ac curacy = 9 . 999999999999999e-012; 

GMAT MyProp .MinSt ep = 0.001; 

GMAT MyProp .MaxStep = 2700; 

GMAT MyProp .MaxStep At tempts = 50; 




I Setup Dialogue Box 
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Chapter 2 


Object Fields: Quick Look-up Tables 

2.1 Spacecraft and Hardware Fields 



Figure 2.1: Spacecraft Dialogue Box / Orbit Tab 


2.1.1 Overview of the Spacecraft Object 

The Spacecraft object is one of the most important resources in GMAT and can be configured in numerous ways. 
For most mission applications, GMAT’s primary use and function is to simulate and model how an actual spacecraft 
would behave (or behaved) in a flight situation. You do this by creating and configuring spacecraft objects, GMAT’s 
mathematical model of real-world spacecraft, and by issuing commands such as Propagate for GMAT to apply to 
the spacecraft model. 

The types of parameters and settings on the Spacecraft Object fall into several categoris: Orbit, Attitude, 
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Ballistic/Mass, Sensors, Tanks, and Actuators. Each of these is configured on a separate tab on the Spacecraft 
dialog box. For example, you can configure the initial state and epoch on the Orbit tab, and the , the mass and 
ballistic properties on the Ballistic/Mass tab. In the following sections we discuss each tab in detail. 

Possible Coupling with Other Objects 

A Spacecraft Requires Other Objects/ Commands of Type: None. 

A Spacecraft has the Potential to Couple with Objects/ Commands of Type: Tank, Thruster, Differential Corrector, 
fminconOptimizer, XYPlot, OpenGLPlot, ReportFile, Variables/ Arrays, Coordinate System, MATLAB Function, 
BeginFiniteBurn, EndFiniteBurn, Function Call, Assignment Command, Maneuver, Propagate, Report, Save, Script 
Event, If, For, While, Vary, Achieve, Minimize, Nonlinear Constraint. 


2.1.2 Spacecraft Orbit Tab 

The Spacecraft/Orbit tab is used to set the orbit state and epoch and is illustrated in Fig. 2.1. On this tab, you can 
choose the epoch, coordinate system, and the state representation in which to enter initial condition information. 
Their are three groups on the Spacecraft/Orbit tab: Epoch, State Configuration, and State Vector. Below, we discuss 
each group in detail. 


Epoch Group 

The Epoch group allows you to select the time system and time format in which to enter the initial Space- 
craft epoch. Several choices are available including AlModJulian, TAIModJulian, UTCModJulian, TTModJulian, 
AlGregorian, TAIGregorian, UTCGregorian, TTGregorian . An epoch can be provided in either the Modified Ju- 
lian Date (with reference epoch 05 Jan 1941 12:00:00.000 TAI) or Gregorian Date formats. As an example, the J2000 
Epoch should be expressed using the Gregorian date format as 01 Jan 2000 12:00.000 (TDB). 

Note that if you change the EpochFormat combo box, and have defined the spacecraft state with respect to a 
time dependent coordinate system, the state vector representation in the GUI does not change. For example, if you 
define a Spacecraft’s state with respect to the Earth Fixed system, and then change the epoch, you have not changed 
the state vector in the Earth Fixed system and therefore the values in the GUI do not change. However, change the 
epoch does change the inertial state that results from converting the Earth Fixed state to the inertial state. This 
is because the orientation of the Earth Fixed frame is different at the new epoch, and so the transformation to the 
inertial frame yields a new results. 


State Configuration Group 

The State Configuration group allows the user to select the coordinate system and state representation for a 
Spacecraft’s initial conditions. The StateType pull-down menu contains several options for the orbit state Represen- 
tation including Cartesian, Keplerian, Modif iedKeplerian, SphericalAZFPA, SphericalRADEC, Equinoctial . 
The Coordinate System pull-down menu allows you to specify the Coordinate System in which the Spacecraft’s ini- 
tial conditions are expressed. The default coordinate systems always appear and are EarthMJ2000Eq,EartliMJ000Ec, 
and EarthFixed. If you create other user defined Coordinate Systems, they also appear in the Coordinate System 
drop-down menu. The numeric values contained in the State Vector group are dynamically updated as changes are 
made to State Type and Coordinate System. For example, if you enter a state vector in EarthMJ2000Eq, hit 
apply, and change the Coordinate System pull-down to Earth Fixed, the GUI will reconfigure to show the equivalent 
state vector in the Earth Fixed system at the defined epoch. 


State Vector Group 

The State Vector group contains the numeric values for a Spacecraft’s initial conditions. The state vector is 
shown in the selected state representation as defined in State Type and is expressed in the requested coordinate 
system defined by Coordinate System. The labels, units, and numeric values dynamically respond to changes in 
either the Coordinate System or State Type pull-down menus. You can use the State Vector to group to define a 
spacecraft’s initial conditions in any coordinate system, or to view the spacecraft’s state in any coordinate system. 
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A detailed discussion of all fields on the Spacecraft Orbit tab is found in Table 2.1. Now let’s look at the Spacecraft 
Attitude tab. 


2.1.3 Spacecraft Attitude Tab 


This Tab is not currently supported in GMAT. It is included only to illustrate look-and-feel of future enhancements. 


2.1.4 Spacecraft Ballistic/ Mass Tab 

The Ballistic/Mass tab, shown in Fig. 2.2is used to set spacecraft mass and ballistic properties. On this panel, 
you can set properties such as DryMass, DragArea, and SRPArea among others. GMAT currently only supports a 
point-mass spacecraft model. In the future GMAT will support a higher fidelity spacecraft model, and this panel 
will allow you to set the spacecraft moments of inertia and other properties. 



Figure 2.2: Spacecraft Dialogue Box / Ballistic/Mass Tab 


Ballistics Group 

The Ballistics group allows the user to specify spacecraft physical properties that are used to calculate properties 
such as the ballistic coefficient. A detailed discussion of all fields on the Spacecraft Ballistic/Mass tab is found in 
Table 2.3. Now let’s look at the Sensors tab. 


2.1.5 Spacecraft Sensors Tab 


This Tab is not currently supported in GMAT. 
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2.1.6 Spacecraft Tanks Tab 


The Spacecraft/Tanks tab allows you to add multiple tanks to a spacecraft. Tanks are created separately from 
spacecraft and if you have not created any tanks, the Available Tanks list will appear empty. You can add an 
existing tank to a spacecraft by selecting the desired tank using a left mouse click and then using a left mouse click 
on the right- arrow icon. If there are no existing tanks, go to the resource tree, right click on the Hardware folder 
that appears as a subfolder to spacecraft, and select Add/Fuel Tank. 



Figure 2.3: Spacecraft Dialogue Box / Tanks Tab 


2.1.7 Spacecraft Actuators Tab 

The spacecraft /Actuators tab allows you to add multiple actuators to a spacecraft. Currently the only actuator that 
GMAT supports are thrusters. You must create a thruster before you can add it to a spacecraft. If you have not 
created any thrusters, the Available Thrusters list will appear empty. You can add existing thrusters to a spacecraft 
by selecting the desired thruster using a left mouse click and then using a left mouse click on the right-arrow icon. 
To create a Thruster, go to the resource tree, right click on the Hardware folder that appears as a subfolder to 
spacecraft, and select Add/Thruster. 
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Figure 2.4: Spacecraft Dialogue Box / Actuators Tab 


Table 2.1: Fields Associated with a Spacecraft Orbit State 
(Orbit Tab) 


Field Options and Description 

StateType Default: Cartesian. Options: [Cartesian, Keplerian, 

Modif iedKeplerian, SphericalAZFPA, SphericalRADEC, Equinoctial ]. 
The StateType field allows the user to configure the type of state vector 
that they wish to use. The Statetype field has a dependency upon the 
CoordinateSystem field. If the Coordinate System chosen by the user 
does not have a gravitational body at the origin, then the state types 
Keplerian, Modif iedKeplerian, and Equinoctial are not permitted. 
This is because these state types require a /i value. Units: N/A. When the 
Keplerian or Modif iedKeplerian state types are selected, the Anomaly 
Type field becomes visible. 

Coordinate System Default: EarthMJ2000Eq. Options: [ EarthMJ2000Eq, EarthMJ2000Ec, 

EarthFixed, or any user defined system]: The Coordinate System field 
allows the user to choose which coordinate system with which to define the 
orbit state vector. The CoordinateSystem field has a dependency upon 
the StateType field. If the Coordinate System chosen by the user does not 
have a gravitational body at the origin, then the state types Keplerian, 
Modif iedKeplerian, and Equinoctial are not permitted. This is because 
these state types require a /i value. Units: N/A. 
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Table 2.1: (Fields Associated with a Spacecraft Orbit State 
(Orbit Tab), continued) 


Field 

Options and Description 

EpochFormat 

Default: TAIModJulian. Options: [AlModJulian, TAIModJulian, 

UTCMod Julian, TTModJulian, AlGregorian, TAIGregorian, 

UTCGregorian, TTGregorian ]: The DateFormat field allows the user to 
specify the format for defining a spacecraft’s initial epoch. DateFormat 
determines both the time system (TAI, TT, etc) and the time format 
(MJD or Gregorian). Units: N/A. 

Epoch 

Default: 21545.000000000. Options: [See Comments]: The Epoch field 
allows the user to specify the initial spacecraft epoch. The format of the 
epoch must be consistent with the DateFormat field. If DateFormat is of the 
“MJD” type, then the epoch is in Modified Julian format. If DateFormat 
is a “Gregorian Type”, the format is similar to 01 Jan 2000 12:00:00.000. 
Units: MJD - days, Gregorian - N/A. 

AnomalyType 

Default: TA. Options: [ TA, MA, EA, HA]: The Epoch field allows the 

user to specify the to select the AnomalyType needed for the Kepler i an 
or Modif iedKeplerian spacecraft state. In the scripting environment, 
AnomalyType is not used. Units: N/A. 


Fields associated with Cartesian state. 

X 

Default: 7100. Options: [ Real Number ]: X is the x-component of 

the Spacecraft state in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km. 

Y 

Default: 0. Options: [ Real Number ]: Y is the y-component of 

the Spacecraft state in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km. 

Z 

Default: 1300. Options: [ Real Number ]: Z is the z-component of 

the Spacecraft state in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km. 

VX 

Default: 0. Options: [ Real Number ]: VX is the x-component of the 
Spacecraft velocity in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km/sec. 

VY 

Default: 7.35. Options: [ Real Number ]: VY is the y-component of 

the Spacecraft velocity in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km/sec. 

VZ 

Default: 1.0. Options: [ Real Number ]: VZ is the z-component of 

the Spacecraft velocity in the coordinate system chosen in the Spacecraft 
CoordinateSystem field. Units: km/sec. 


NOTE: Default values for the remaining state types are obtained through 
transformations of the default Cartesian spacecraft state values. The 
Keplerian, Modif iedKeplerian, and Equinoctial are dependant on the 
origin of the CoordinateSystem, because the state types require a /i value. 
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Table 2.1: (Fields Associated with a Spacecraft Orbit State 
(Orbit Tab), continued) 



Field 

Options and Description 


Fields associated with Keplerian state. 

SMA 

Default: 7191.938817629. Options: [Real Number ^ 0 ]: The SMA field 
is the spacecraft orbit’s osculating Keplerian semimajor axis in coordinate 
system chosen in the Spacecraft CoordinateSystem field. SMA must be 
strictly greater than or less than zero. For circular and elliptical (0 < ECC 
< 1) orbits SMA should only be a positive Real Number and for hyperbolic 
orbits (ECC > 1) SMA should only be a negative Real Number. GMAT 
does not support the creation of parabolic orbits. Units: km. 

ECC 

Default: 0.024549749. Options: [ 0 < Real Number, ECC^ 1 ]: The ECC 
field is the spacecraft orbit’s osculating eccentricity. ECC must be greater 
than or equal to zero but not equal to one (GMAT does not support 
parabolic orbits). Note: ECC can be greater thanone. See the SMA de- 
scription for additional restrictions to the allowable values of ECC. Units: 
Dimensionless. 

INC 

Default: 12.850080057. Options: [Real Number]: The INC field is the 
spacecraft orbit’s osculating inclination, in degrees, w/r/t to the selected 
coordinate system. Units: degrees. 

AOP 

Default: 314.190551536. Options: [Real Number] :The AOP field is the 
spacecraft orbit’s osculating argument of periapsis, in degrees, w/r/t to the 
selected coordinate system. Units: degrees. 

RAAN 

Default: 306.614802195. Options: [Real Number]: The RAAN field is 
the spacecraft orbit’s osculating right ascension of the ascending node, in 
degrees, w/r/t to the selected coordinate system. Units: degrees. 

TA 

Default: 99.887749332. Options: [Real Number]: The TA field is the space- 
craft orbit’s osculating true anomaly. Units: degrees. 

MA 

Default: 97.107826639. Options: [Real Number]: The MA field is the 
spacecraft orbit’s osculating mean anomaly. Units: degrees. 

EA 

Default: 98.498977103. Options: [Real Number]: The EA field is the space- 
craft orbit’s osculating eccentric anomaly. Units: degrees. 

HA 

Default: 0.000000000. Options: [Real Number]: The HA field is the space- 
craft orbit’s osculating hyperbolic anomaly. Units: degrees. 

Fields associated with Modif iedKeplerian state. 

RadApo 

Default: 7015.378524789. Options: [Real Number ^ 0 ]: The RadApo field 
is the spacecraft orbit’s osculating radius of apoapsis. RadApo must be 
strictly greater than or less than zero. When RadApo is negative, the orbit 
is hyperbolic. Units: km. 
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INC 
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RAAN 

TA 

MA 

EA 

HA 






CHAPTER 2 . OBJECT FIELDS: QUICK LOOK-UP TABLES 

Table 2.1: (Fields Associated with a Spacecraft Orbit State 
(Orbit Tab), continued) 


Options and Description 

Default: 7368.4991104681 Options: [Real Number > 0 ]: The RadPer field 
is the spacecraft orbit’s osculating radius of periapsis. RadPer must be 
greater than zero. Units: km. 

See the Kepler i an state section for a description on this field. 

See the Kepler i an state section for a description on this field. 

See the Kepler i an state section for a description on this field. 

See the Kepler i an state section for a description on this field. 

See the Kepler i an state section for a description on this field. 

See the Kepler i an state section for a description on this field. 

See the Kepler i an state section for a description on this field. 


Fields associated with SphericalAZFPA state. 

RMAG Default: 7218.03297304. Options: [Real Number > 0]: The RMAG field 

allows the user to set the magnitude of the spacecrafts position vector. 
Units: km. 

RA Default: 0. Options: [Real Number]: The RA field allows the user to set 

the spacecraft’s right ascension. Units: degrees. 

DEC Default: 10.3758449200. Options: [Real Number]: The DEC field allows the 

user to set the spacecraft’s declination. Units: degrees. 

VMAG Default: 7.41771528167. Options: [Real Number > 0]: The VMAG field 

allows the user to set the magnitude of the spacecraft’s velocity. Units: 
km/ sec. 

AZI Default: 82.377421681. Options: [Real Number]: The AZI field allows the 

user to set the spacecraft’s azimuth angle. Units: degrees. 

FPA Default: 88.60870365370. Options: [Real Number]: The FPA allows the 

user to set a spacecraft’s flight path angle. Units: degrees. 


RMAG 

See the 

RA 

See the 

DEC 

See the 

VMAG 

See the 


Fields associated with SphericalRADEC state. 
SphericalAZFPA state section for a description on this field. 
SphericalAZFPA state section for a description on this field. 
SphericalAZFPA state section for a description on this field. 
SphericalAZFPA state section for a description on this field. 



. SPACECRAFT AND HARDWARE FIELDS 


Table 2.1: (Fields Associated with a Spacecraft Orbit State 
(Orbit Tab), continued) 


Field 

Options and Description 

RAV 

Default: 90. Options: [Real Number]: The RAV field i allows the user to set 
the right ascension of the spacecraft’s velocity. Units: degrees. 

DECV 

Default: 7.7477720361. Options: [Real Number]: The DECV field allows the 
user to set the declination of the spacecraft’s velocity. Units: degrees. 

Fields associated with Equinoctial elements. 

SMA 

See the Kepler i an state section for a description on this field. 

h 

Default: -0.024234314. Options: [Real Number]: The h field is the projec- 
tion of the eccentricity vector onto the y ep axes. The T ep system is a system 
used in calculating the equinoctial elements and is beyond the scope of this 
discussion. The GMAT Mathematical Specifications document discusses 
T ep and the calculation of the equinoctial elements in detail. Units: None. 

k 

Default: -0.003922779. Options: [Real Number]: The k field is the projec- 
tion of the eccentricity vector onto the x ep axes. The T ep system is a system 
used in calculating the equinoctial elements and is beyond the scope of this 
discussion. The GMAT Mathematical Specifications document discusses 
T ep and the calculation of the equinoctial elements in detail. Units: None. 

P 

Default: -0.090388347. Options: [Real Number]: The p field is the projec- 
tion of the N vector onto the y ep axes. The N vector and the T ep system 
are used in calculating the equinoctial elements and are beyond the scope 
of this discussion. The GMAT Mathematical Specifications document dis- 
cusses N and T ep and the calculation of the equinoctial elements in detail. 
Units: None. 

q 

Default: 0.067164549. Options: [Real Number]: The q field is the projec- 
tion of the N vector onto the x ep axes. The N vector and the T ep system 
are used in calculating the equinoctial elements and are beyond the scope 
of this discussion. The GMAT Mathematical Specifications document dis- 
cusses N and T ep and the calculation of the equinoctial elements in detail. 
Units: None. 

MeanLongitude 

Default: 3.16359946. Options: [Real Number]: The MeanLongitude field 
is the the spacecraft’s mean longitude. The GMAT Mathematical Spec- 
ifications document discusses mean longitude and the calculation of the 
equinoctial elements in detail. Units: degrees. 
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Table 2.2: Fields Associated with Spacecraft Physical Properties 
(Ballistic/Mass Tab) 


Field 

Options and Description 

Dry Mass 

Default: 850. Options: [Real Number > 0]: The DryMass field allows the 
user to specify the mass of the spacecraft structure, but does not include 
the mass of tanks, thrusters, or fuel. Units: kg. 

Cd 

Default: 2.2. Options: [Real Number > 0]: The Cd field allows the user to 
specify the spacecraft’s drag coefficient. Units: None. 

Cr 

Default: 1.8. Options: [Real Number > 0]: The Cr field allows the user to 
specify the spacecraft’s coefficient of reflectivity. Units: None. 

DragArea 

Default: 15. Options: [Real Number > 0]: The DragArea is the effective 
spacecraft area used in calculate the force due to drag. Units: m 2 . 

SRPArea 

Default: 1. Options: [Real Number > 0]: The SRPArea is the effective 
spacecraft area used in calculate the force due to solar radiation pressures. 
Units: m 2 . 

Table 2.3: Fields Associated with a Spacecraft Ballistic and Mass 
Properties 

Field 

Options and Description 

Cd 

Default: 2.2. Options: [Real Number >0]: Cd is the spacecraft’s drag 
coefficient. Cd must be greater than 0. Units: Dimensionless. 

Cr 

Default: 2.2. Options: [0 < Real Number < 2.0]: Cr is the spacecraft’s 
coefficient of reflectivity. Cr must be greater than 0. Units: Dimensionless. 

DragArea 

Default: 15.0. Options: [Real Number > 0]: The DragArea is the area of 
the spacecraft that is used in calculating atmospheric drag. DragArea must 
be greater than 0. Units: m 2 

SRPArea 

Default: 1.0. Options: [Real Number > 0]: The SRPArea is the area of 
the spacecraft that is used in calculating the force due to solar radiation 
pressure. SRPArea must be greater than 0. Units: m 2 

Dry Mass 

Default: 850.0. Options: [Real Number > 0]: The DryMass is the mass of 
the spacecraft without the mass of tanks and fuel. DryMass must be greater 
than 0. Units: kg 
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Table 2.4: Fields Associated with Spacecraft Attitude State 
(Attitude Tab) 


Field Options and Description 

Attitude Default: CSFixed. Options: [ CSFixed, Spinner]: The AttitudeMode mode field allows the 

Mode user to specify the attitude dynamics model to be used by GMAT to propagate a spacecraft’s 

attitude. The attitude dynamics model uses the initial attitude state and the algorithm 
associated with AttitudeMode to advance the attitude state in time. Units: N/A. 


Attitude 

Coordinate 

System 


Default: EarthMJ2000Eq. Options: [ EarthMJ2000Eq, EarthMJ2000Ec, EarthMJ2000Eq, 
or any user defined system]: A spacecraft’s initial body axes orientation as defined 

by the quaternions or some other parameterizations are expressed with respect to the 
AttitudeCoordinateSystem. Unlike an orbit state, an attitude state is really informa- 
tion that uniquely defines a rotation matrix. A spacecraft’s attitude is the orientation of 
the spacecraft’s body-fixed frame with respect to the inertial frame. However, it is often 
more convenient to define the initial attitude with respect to an intermediate frame than 
with respect to an inertial frame. The Attitude Co ordinate System allows the user to 
define the initial orientation of a spacecraft’s body axes, with respect to any frame GMAT 
knows how to calculate. Units: N/A. 


Attitude Default: EulerAngles. Options: [Euler Angles, Quaternions, DCM]: The 

StateType AttitudeStateType field allows the user to choose among different attitude parame- 
terizations when defining the attitude initial conditions. Units: N/A. 


Attitude Default: EulerAngleRates. Options: [Euler AngleRates, AngularVelocity]: The 

Rate AttitudeRateStateType field allows the user to define the attitude parameterization to 

StateType be used in defining the initial attitude rate. Units: N/A. 


Euler 

Angle 

Sequence 


Default: 312. Options:[ 123, 132, 121, 131, 213, 231, 212, 232, 312, 321, 313, 
323 ]: The EulerAngleSequence field allows the user to define the Euler sequence used in 
rotating from the body-fixed to the inertial axes. For example, if EulerAngleSequence is 
selected as 321, then the first rotation is a 3 rotation through EulerAnglel, the second 
rotation is a 2 rotation through EulerAngle2, and the third rotation is a 1 rotation through 
EulerAngle3. Units: N/A. 


Fields associated with Spacecraft Attitude State 


EulerAnglel Default: 0. Options: [Real Number]: EulerAnglel is one of three Euler angles that can be 
used to define the initial conditions of a spacecraft. EulerAnglel corresponds to the first 
rotation performed in the sequence that goes from the spacecraft body frame to the inertial 
frame. For example, if the EulerAngleSequence field is set to 321, the first rotation from 
the body to the inertial frame would be a 3-rotation throughEul er Angle 1. Units: degrees. 

Euler Angle2 Default: 0. Options: [Real Number]: Euler Angle2 is one of three Euler angles that can be 
used to define the initial conditions of a spacecraft. EulerAngle2 corresponds to the second 
rotation performed in the sequence that goes from the spacecraft body frame to the inertial 
frame. For example, if the EulerAngleSequence field is set to 321, the second rotation from 
the body to the inertial frame would be a 2-rotation throughEul erAngle2. Units: degrees. 


Euler Angle3 Default: 0. Options: [Real Number]: Euler Angle3 is one of three Euler angles that can be 
used to define the initial conditions of a spacecraft. EulerAngle3 corresponds to the third 
rotation performed in the sequence that goes from the spacecraft body frame to the inertial 
frame. For example, if the EulerAngleSequence field is set to 321, the third rotation from 
the body to the inertial frame would be a 1-rotation throughEulerAngle3. Units: degrees. 
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Field 

qi 


q2 


q3 


q4 


DCMll 


DCM12 


DCM33 


Euler Angle 
Rat el 


Euler Angle 
Rate2 


Euler Angle 
Rate3 


Angular 

VelocityX 


Angular 

VelocityY 


Angular 

VelocityZ 


CHAPTER 2 . OBJECT FIFJLjDS: QUICK LOOK-UP TABLES 

Table 2.4: (Fields Associated with Spacecraft Attitude State 
(Attitude Tab) ....continued) 


Options and Description 

Default: 0. Options: [Real Number]: The ql parameter is the first element of the quaternion. 
GMAT normalizes the quaternion to be of length 1. Units: degrees. 

Default: 0. Options: [Real Number]: The q2 parameter is the second element of the quater- 
nion. GMAT normalizes the quaternion to be of length 1. Units: degrees. 

Default: 0. Options: [Real Number]: The q3 parameter is the third element of the quaternion. 
GMAT normalizes the quaternion to be of length 1. Units: degrees. 

Default: 1. Options: [Real Number]: The q4 parameter is the fourth element of the quater- 
nion. GMAT normalizes the quaternion to be of length 1. Units: degrees. 

Default: 1. Options: [Real Number]: The DCMll parameter is the upper left component of 
the direction cosine matrix that rotates from the spacecraft body frame to the inertial frame. 
GMAT normalizes the attitude matrix to have a determinant of 1. The default DCM matrix 
is the identity matrix. Units: None. 

Default: 0. Options: [Real Number]: The DCM12 parameter is the R 12 component of the 
direction cosine matrix that rotates from the spacecraft body frame to the inertial frame. 
GMAT normalizes the attitude matrix to have a determinant of 1. The default DCM matrix 
is the identity matrix. Units: None. 

Default: 1. Options: [Real Number]: The DCM33 parameter is the R33 component of the 
direction cosine matrix that rotates from the spacecraft body frame to the inertial frame. 
GMAT normalizes the attitude matrix to have a determinant of 1. The default DCM matrix 
is the identity matrix. Units: None. 

Default: 0. Options: [Real Number]: The EulerAngleRatel defines the time-rate-of-change 
of Euler Angle 1, expressed in the the system defined by AttitudeCoordinateSystem. Units: 
deg/sec. 

Default: 0. Options: [Real Number]: The EulerAngleRate2 defines the time-rate-of-change 
of Euler Angle2, expressed in the the system defined by AttitudeCoordinateSystem. Units: 
deg/sec. 

Default: 0. Options: [Real Number]: The EulerAngleRate3 defines the time-rate-of-change 
of Euler Angle3, expressed in the the system defined by AttitudeCoordinateSystem. Units: 
deg/sec. 

Default: 0. Options: [Real Number]: The AngularVelocityX component is the x- 

component of the spacecraft’s body axes with respect to the system defined by 

AttitudeCoordinateSystem. Units: deg/sec. 

Default: 0. Options: [Real Number]: The AngularVelocityY component is the y- 

component of the spacecraft’s body axes with respect to the system defined by 

AttitudeCoordinateSystem. Units: deg/sec. 

Default: 0. Options: [Real Number]: The AngularVelocityZ component is the z- 

component of the spacecraft’s body axes with respect to the system defined by 

AttitudeCoordinateSystem. Units: deg/sec. 
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Table 2.5: Fields Associated with a Spacecraft Tank (Tati ks Tab) 


Field 


Options and Description 

FuelMass 


Default: 756. Options: [Real Number > 0]: The FuelMass field is the mass 
of fuel in the tank. Units: kg. 

Pressure 


Default: 1500. Options: [Real Number > 0]: The Pressure field is the 
pressure of the fuel in the tank. Units: kPa. 

Temperature 


Default: 20. Options: [Real Number]: The Temperature field is the tem- 
perature of the fuel in the tank. Units: C. 

Ref Temperature 


Default: 20. Options: [Real Number]: Ref Temperature Units: C. 

Volume 


Default: 0.75. Options: [Real Number > 0]: The Volume field is the volume 
of the tank. Units: m 3 . 

FuelDensity 


Default: 1260. Options: [Real Number > 0]: The FuelDensity parameter 
is the fuel density. Units: kg/m 3 

PressureRegulated 

Default: true. Options: [true false]: The PressureRegulated flag allows 
the user to choose between a pressure regulated tank or a blow down tank. If 
PressureRegulated is true, then the pressure is held constant as fuel mass 
is depleted. If PressureRegulated is false, then the pressure decreases as 
fuel is depleted. 

Table 2.6: Fields Associated with a Spacecraft Thruster 
(Actuators Tab) 

Field 


Options and Description 


CoordinateSystem Default: EarthMJ2000Eq. Options: [ EarthMJ2000Eq, EarthMJ2000Ec, 


EarthMJ2000Eq, or any user defined system]: The CoordinateSystem field 
for a thruster determines what coordinate system the orientation parame- 
ters X_Direction, Y_Direction, and Z_Direction are referenced to. This 
is a temporary fix in GMAT. Eventually, the user will specify the attitude 
of a spacecraft, and then X_Direction, Y_Direction, and Z_Direction will 
be referenced to the spacecraft body frame. 

Axis Default: VNB. Options: [inertial VNB]: The Axis field allows the user to 

define a local coordinate system for a thruster. Note that there is a coupling 
between the Axis parameter and the CoordinateSystem parameter for a 
thruster. Only one of the two can be specified. Units: N/A. 

Origin Default: Earth. Options: [Sun, Mercury, Venus, Earth, Luna, Mars, 

Jupiter, Saturn, Uranus, Neptune, Pluto ]: The Origin field allows the 
user to define a local origin for a thruster. Note that there is a coupling 
between the Origin parameter and the CoordinateSystem parameter for 
a thruster. Only one of the two can be specified. Units: N/A. 

X_Direction Default: 1. Options: [Real Number]: X_Direction, divided by the RSS 

of the three direction components, forms the x direction of the spacecraft 
thrust vector direction. 
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Table 2.6: Fields Associated with a Spacecraft Thruster 
(Actuators Tab) (continued) 


Field Options and Description 

Y_Direction Default: 0. Options: [Real Number]: Y_Direction, divided by the RSS 

of the three direction components, forms the y direction of the spacecraft 

thrust vector direction. 

Z_Direction Default: 0. Options: [Real Number]: Z_Direction, divided by the RSS 

of the three direction components, forms the z direction of the spacecraft 

thrust vector direction. 

ThrustS caleFact or Default: 1. Options: [Real Number > 0]: ThrustScaleFactor is a scale 

factor that is multiplied by the thrust vector for a given thruster, before 
the thrust vector is added into the total accleration. Units: None. 

Tank Default: None. Options: [Tank Name]: The Tank field specifies which tank 

the thruster draws propellant from. 

The constants C{ below are used in the following equation to calculate 
thrust Ft as a function of pressure P and temperature T 


F t (P,T) 


{Cl + C 2 P + C 3 P 2 + C 4 P Cr ‘ + C 6 P° 7 + C 8 P c ° 

K rn \ 1+C ? 13+C r i4^ > 


Cl 

C2 

C3 

C4 

C5 

C6 

C7 

C8 

C9 

CIO 

Cll 

C12 

C13 

C14 


Default: 

Default: 

Default: 

Default: 

Default: 

Default: 

Default: 

Default: 

Default: 

Default: 

Default: 

Default: 

Default: 

Default: 


500. Options: [Real Number]: Thrust coefficient. Units: N 
0. Options: [Real Number]: Thrust coefficient. Units: N/kPa. 

0. Options: [Real Number]: Thrust coefficient. Units: N/kPa 2 

0. Options: [Real Number]: Thrust coefficient. Units: N/kPa^ 5 . 

0. Options: [Real Number]: Thrust coefficient. Units: None 

0. Options: [Real Number]: Thrust coefficient. Units: N/kPa^ 7 . 

0. Options: [Real Number]: Thrust coefficient. Units: None 

0. Options: [Real Number]: Thrust coefficient. Units: N/kPa C9 . 

0. Options: [Real Number]: Thrust coefficient. Units: None 

0. Options: [Real Number]: Thrust coefficient. Units: N. 

1. Options: [Real Number]: Thrust coefficient. Units: None 

0. Options: [Real Number]: Thrust coefficient. Units: 1/kPa. 

0. Options: [Real Number]: Thrust coefficient. Units: None. 

0. Options: [Real Number]: Thrust coefficient. Units 1/kPa. 
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Table 2.6: Fields Associated with a Spacecraft Thruster 
(Actuators Tab) (continued) 


Field 


Options and Description 

The constants K{ below are used in the following equation to calculate Isp 
as a function of pressure P and temperature T 


I sp (P,T) 


[k x + K 2 P + K 3 P 2 + K 4 P k -‘ + K g P k 7 + K 8 P k ° + k 10 k“ 1 * p } 



1+K 13 +K 1a P 


K1 

K2 

K3 

K4 

K5 

K6 

K7 

K8 

K9 

K10 

Kll 

K12 

K13 

K14 


Default: 2150. Options: [Real Number]: Isp coefficient. Units: m/sec 

Default: 0. Options: [Real Number]: Isp coefficient. Units: m/(sec- kPa). 

Default: 0. Options: [Real Number]: Isp coefficient. Units: m/(sec- kPa 2 ) 

Default: 0. Options: [Real Number]: Isp coefficient. Units: m/(sec* 

kPa* 5 ). 


Default: 0. Options: [Real Number]: Isp coefficient. Units: None 

Default: 0. Options: [Real Number]: Isp coefficient. Units: m/(sec- 

kPa* 7 ). 


Default: 0. Options: [Real Number]: Isp coefficient. Units: None 
Default: 0. Options: [Real Number]: Isp coefficient. Units: m/(sec- kPa K9 . 
Default: 0. Options: [Real Number]: Isp coefficient. Units: None 

Default: 0. Options: [Real Number]: Isp coefficient. Units: m/sec. 

Default: 1. Options: [Real Number]: Isp coefficient. Units: None 

Default: 0. Options: [Real Number]: Isp coefficient. Units: 1/kPa. 

Default: 0. Options: [Real Number]: Isp coefficient. Units: None. 

Default: 0. Options: [Real Number]: Isp coefficient. Units 1/kPa. 


2.2 Propagator Fields 
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Table 2.7: Fields Associated with a, Force Model 


Field 

CentralBody 


PrimaryBodies 


Options and Description 

Default: Earth. Options: [ Sun, Mercury, Venus, Earth, Luna, 
Mars, Jupiter, Saturn, Uranus, Neptune, Pluto ]: The Cen- 

tralBody field allows the user to select the origin for the propaga- 
tion. All propagation occurs in the FK5 axes system, about the 
CentralBody chosen by the user. The CentralBody must be a grav- 
itational body and so cannot be a LibrationPoint or other special 
point. Units: N/A. 

Default: {Earth}. Options: [ Sun, Mercury, Venus, Earth, Luna, 
Mars, Jupiter, Saturn, Uranus, Neptune, Pluto ]: The Pri- 

maryBodies field is a list of all celestial bodies that are to be 
modelled with a force model more complex than point mass grav- 
ity Lists are surrounded by curly braces. For each PrimaryBody, 
the user can choose a drag, magnetic field, and aspherical gravity 
model. There is a coupling between the PrimaryBodies filed and 
the PointMasses field. A primary body can be any planet or moon 
not included in the PointMasses field. Units: N/A. 


Gravity. PrimaryB odi/.PotentialFile Default: JGM2. Options: [ CentralBody-based models, Other. See 

Comments ]. This field allows the user to define the source for the 
non-spherical gravity coefficients for a primary body. If a grav- 
ity file is located in the Primary Body’s potential path as defined 
in the startup file, you only need to specify the model name and 
not the entire path. For example, if the JGM2 coefficients file is 
contained in the directory defined in the startup file by the fine 
EARTH_POT_PATH, then you only need to specify the model 
name JGM2. If the model is not contained in the body’s poten- 
tial path, you must supply the entire path as well as the file name. 
If GMAT does not successfully find the file requested, it uses the 
default gravity model as defined in the startup file. From the GUI, 
only models for Earth appear if Earth is the active primary body. 
This is to avoid allowing the user to select a lunar potential model 
for the Earth. If the Other option is selected the user has the abil- 
ity of selecting a gravity model file on their local computer. Units: 
None. 

Gravity,PrimaryBody,Degree Default: 4. Options: [ Integer >0 and < the maximum specified by 

the model, Order < Degree ]. This field allows the user to select the 
the degree, or number of zonal terms, in the non-spherical gravity 
model. Ex. Gravity .Earth. Degree = 2 tells GMAT to use only 
the J2 zonal term for the Earth. The value for Degree must be less 
than the maximum degree specified by the Model. Units: None. 

Gravity. Primary Body. Order Default: 4. Options: [ Integer >0 and < the maximum specified by 

the model, Order < Degree ]. This field allows the user to select 
the the order, or number of tesseral terms, in the non-spherical 
gravity model. Ex. Gravity.Earth. Order = 2 tells GMAT to use 
2 tesseral terms. Note: Order must be greater than or equal to 
Degree. Units: None. 
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Table 2.7: (Fields Associated with a Force Model... continued) 


Field 

Drag 


Drag . AtmosphereModel 


Drag. FI 07 


Drag.F107A 


Drag . Magnet i c Index 


SRP 


PointMasses 


Options and Description 

Default: None. Options: [None, JachhiaRoberts, MSISE90, 

Exponential ]. The Drag field allows a user to specify a drag 
model. Currently, only one drag model can be chosen for a partic- 
ular propagator and only Earth models are available. Units: N/A. 
Note: This field will be depreeated in future versions of GMAT. 
Currently, the Drag field and the Drag. AtmosphereModel field 
must be set to the same value. 

Default: None. Options: [JachhiaRoberts, MSISE90, 

Exponential ]. The Drag. AtmosphereModel field allows a user 
to specify a drag model. Currently, only one drag model can be 
chosen for a particular propagator and only Earth models are avail- 
able. Units: N/A. 

Default: 150. Options: [ Real Number > 0 ]. The F107 field allows 
you to set the F\o .7 solar flux value used in computing atmospheric 
density. F 10.7 is the solar radiation at a wavelength of 10.7 cm. 
Units: W/m 2 /Hz 

Default: 150. Options: [ Real Number > 0 ]. The F107A field 
allows you to set the average F 10.7 value. F\ 0.7 is the average of 
F 10.7 over one month. Units: W/m 2 /Hz 

Default :3. Options: [ 0 < Real Number < 9 ]: The Magnetic Index 
index field allows you to set the k p value for use in atmospheric 
density calculations. k p is a planetary 3-hour- aver age, geomagnetic 
index that measures magnetic effects of solar radiation. Units: 
None. 

Default: Off. Options: [ On, Off ]. The SRP field allows the user to 
include the force due to solar radiation pressure in the total sum 
of forces. Units: N/A. 

Default: None. Options [ Sun, Mercury, Venus, Earth, Luna, Mars, 
Jupiter, Saturn, Uranus, Neptune, Pluto ]. A PointMass is a 
planet or moon that is modelled by a point source located at its 
center of gravity. A PointMass body can be any planet or moon 
not included in the PrimaryBodies field. Units: N/A. 
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Table 2.7: (Fields Associated with a Force Model... continued) 


Field Options and Description 

ErrorControl Default: RSSStep. Options: [ RSSStep, RSSState, LargestState, 

Large st Step]: The ErrorControl field allows you to choose how 
a Propagator measures the error in an integration step. The algo- 
rithm selected in the ErrorControl field is used to determine the 
error in the current step, and this error is compared to the value 
set in the Accuracy field to determine if the step has an accept- 
able error or needs to be improved. All error measurements are 
relative error, however, the reference for the relative error changes 
depending upon the selection of ErrorControl. RSSState is the 
Root Sum Square (RSS) relative error measured with respect to 
the current step. RSSState is the (RSS) relative error measured 
with respect to the current state. Largest Step is the state vector 
component with the largest relative error measured with respect 
to the current step. LargestState is the state vector component 
with the largest relative error measured with respect to the current 
state. For a more detailed discussion see the GMAT Mathematical 
Specification. Units: N/A. 


Table 2.8: Fields Associated with an Integrator 


Field 


Options and Description 


Fields associated with All Integrators 

Type Default: RungeKutta89. Options: [ RungeKutta89, RungeKutta68, 

RungeKutta56, PrinceDormand45, PrinceDormand78, BulirschStoer, 
AdamsBashforthMoulton ]: The Type field is used to set the type of 

numerical integrator. Units: N/A. 

InitialStepSize Default: 60 (sec). Options: [ Real Number ]. The InitialStepSize is 

the size of the first attempted step by the integrator. If the step defined by 
InitialStepSize does not satisfy Accuracy, the integrator adapts the step 
according an algorithm defined in the mathematical specifications document to 
find an acceptable first step that meets the user’s requested Accuracy. Units: 
sec. 

Default: le-11. Options: [ Real Number > 0 ]. The Accuracy field is used 
to set the desired accuracy for an integration step. Units: N/A. When you 
set a value for Accuracy, GMAT uses the method selected in ErrorControl 
field on the Force Model, to determine a metric of the accuracy. For each step, 
the integrator ensures that the accuracy, as calculate using the method define 
by ErrorControl, is less than the limit defined by Accuracy. If an integrator 
exceeds MaxStep At tempts trying to meet the requested accuracy, and error 
message is thrown and propagation stops. 

Default: .001 (sec). Options: [ Real Number >0, MinSt ep < MaxStep ]. The 
MinSt ep field is used to set the minimum allowable step size. Units: sec. 

Default: 2700.0 (sec.). Options: [ Real Number > 0, MinSt ep < MaxStep ]. 
The MaxStep field is used to set the maximum allowable step size. Units: sec. 


Accuracy 


MinStep 

MaxStep 
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Table 2.8: Fields Associated with an Integrator.... (continued) 


Field 

Options and Description 

MaxS t ep At t empt s 

Default: 50. Options: [ Integer > 0]. The Max St epAt tempts field allows the 

user to set the number of attempts the integrator takes to meet the tolerance 
defined by Accuracy. Units: None. 

Fields associated only with Adams-Bashforth-Moulton Integrator 

Minlntegrat ionErr or 

Default: 1.0e-13. Options: [ Real Number > 0, Minlntegrat ionErr or < 
Nomlntegr at ionErr or < Accuracy ]: The Minlntegrat ionError field is used 
by the ABM integrator (and other predictor-corrector integrators when imple- 
mented) as the desired integration error to be obtained when the step size is 
changed. Predictor-Corrector integrators adapt step size when the obtained in- 
tegration error falls outside of the range of acceptable steps, as determined by 
the bounds set by the Minlntegrat ionError and Accuracy fields. The integra- 
tor then applies an internal calculation to recompute the step size, attempting 
to hit the Nomlntegrat ionError, and restarts the integrator. Units: N/A. 

N omlnt egr at i onErr or 

Default: 1.0e-ll. Options: [ Real Number > 0, Minlntegrat ionError < 
Nomlntegrat ionError < Accuracy ]: The Nomint egr at ionErr or field is used 
by the ABM integrator (and other predictor-corrector integrators when imple- 
mented) as the desired integration error to be obtained when the step size is 
changed. Predictor-Corrector integrators adapt step size when the obtained in- 
tegration error falls outside of the range of acceptable steps, as determined by 
the bounds set by the MinlntegrationError and Accuracy fields. The integral 
tor then applies an internal calculation to recompute the step size, attempting 
to hit the Nomlntegrat ionError, and restarts the integrator. Units: N/A. 


Script Examples 
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Table 2.8: Fields Associated with an Integrator.... (continued) 


Field 


Options and Description 


Create ForceModel MyProp_ForceModel ; 

GMAT MyProp_ForceModel. CentralBody = Earth; 

GMAT MyProp_ForceModel.PrimaryBodies = {Earth}; 

GMAT MyProp_ForceModel.PointMasses = {Sun, Luna}; 

GMAT MyProp_ForceModel.Drag = None; 

GMAT MyProp.For ceModel. SRP = Off; 

GMAT MyProp_ForceModel.ErrorControl = RSSStep; 

GMAT MyProp_ForceModel. Gravity .Earth. Degree = 4; 

GMAT MyProp_ForceModel . Gravity .Earth. Order = 4; 

GMAT MyPr op_For ceModel. Gravity .Earth. Potent ialFile =/JGM2v; 

Create Propagator MyProp; 

GMAT MyProp.FM = MyProp _For ceModel; 

GMAT MyProp. Type = RungeKutta89 ; 

GMAT MyProp . InitialStepSize = 60; 

GMAT MyProp .Accuracy = 9 . 999999999999999e-012; 

GMAT MyProp .MinSt ep = 0.001; 

GMAT MyProp .MaxStep = 2700; 

GMAT MyProp .MaxSt ep At tempts = 50; 


2 . 3 Maneuvers 


Tabic 2.9: Fields Associated with ail Impulsive Bum 


Field Options and Description 

Origin Default: Earth . Options: [Any celestial body]: Together the Origin and 

Axes fields describe the coordinate system in which a maneuver is applied. 
The Origin field determines the origin of the maneuver coordinate system. 
The ability to define the coordinate system locally avoids having to create 
many coordinate systems, associated with specific spacecraft, in order to 
perform finite maneuvers for multiple spacecraft. Units: N/A. 

Axes Default: VNB . Options: [VNB,MJ2000Eq]: The Axes field, together with 

the Origin field, describe the coordinate system in which an impulsive 
maneuver is applied. If VNB is chosen for Axes, a local coordinate system is 
created such that the x-axis points in the velocity direction of the spacecraft, 
with respect to the point defined by Origin, the y-axis points in the normal 
direction of the spacecraft with respect to Origin, and the z-axis completes 
the right-handed set. Units: N/A. 

VectorFormat Default: Cartesian . Options: [Cartesian, Spherical]: The 

VectorFormat field allows the user to define the format of the maneuver 
vector. Units: N/A. 

Element 1 Default: 0. Options: [Real Number]: The Element 1 field allows the user 

to define the first element of the impulsive maneuver vector. Element 1 is 
x if VectorFormat is Cartesian. Element 1 is the magnitude of the burn 
if VectorFormat is spherical. Units: km/sec. 



2.4. SOLVER. FIELDS 


Table 2.9: (continued) 


Field Options and Description 

Element2 Default: 0. Options: [Real Number]: The Element2 field allows the user 

to define the second element of the impulsive maneuver vector. Element 2 
is y if VectorFormat is Cartesian. Units: km/sec. 

Element3 Default: 0. Options: ]Real Number]: The Element3 field allows the user 

to define the second element of the impulsive maneuver vector. Element 3 
is z if VectorFormat is Cartesian. Units: km/sec. 


Tabic 2.10: Fields Associated with a Finite Burn 


Field 

Options and Description 

Origin 

Default: Earth . Options: [Any celestial body, libration point, or barycen- 
ter]: Together the Origin and Axes fields describe the coordinate system 
in which a maneuver is applied. The Origin field determines the origin 
of the maneuver coordinate system. The ability to define the coordinate 
system locally avoids having to create many coordinate systems, associated 
with specific spacecraft, in order to perform finite maneuvers for multiple 
spacecraft. Units: N/A. 

Axes 

Default: VNB . Options: [VNB, MJ2000Eq ]: The Axes field, together with 
the Origin field, describe the coordinate system in which a finite maneuver 
is applied. If VNB is chosen for Axes, a local coordinate system is created 
such that the x-axis points in the velocity direction of the spacecraft, with 
respect to the point defined by Origin, the y-axis points in the normal 
direction of the spacecraft with respect to Origin, and the z-axis completes 
the right-handed set. Units: N/A. 

Thrusters 

Default: No Default. Options: [Any thruster created by user]: The 

Thrusters field allows the selection of which thrusters to use when 
applying a finite maneuver. The user can select more than one 

thruster, from the list of thrusters previously created, by including all 
thrusters in curly braces. An example is MyFiniteBurn. Thrusters = 
{Thrusterl , Thrust er2 , Thrust er3}. Units: N/A. 

BurnS caleFact or 

Default: 1.0 . Options: [Real Number]: The BurnS caleFact or is used 
to scale the total acceleration before adding the acceleration due to a fi- 
nite burn into the sum of the accelerations of a spacecraft. The scaling is 
performed by taking the sum of the accelerations applied by all thrusters 
specified under the Thrusters field, and multiplying the total thrust by 
BurnS caleFact or. Units: None. 


2.4 Solver Fields 


Table 2.11: Fields Associated with the Infineon Solver 


Field Options and Description 
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Table 2.11: (Fields Associated with the fmincon 

Solver. . . .continued) 

Field Options and Description 

Dif fMax Default: 0.1 . Options: [Real Number > 0]: The Dif fMaxChange parameter sets the upper 

Change limit on the perturbation used in MATLAB’s finite differencing algorithm. For fmincon, 

you don’t specify a single perturbation value, but rather give MATLAB a range, and it uses 
an adaptive algorithm that attempts to find the optimal perturbation. Units: N/A . 

Dif f Min Default: le-8 . Options: [Real Number > 0]: The Dif fMinChange parameter sets the lower 

Change limit on the perturbation used in MATLAB’s finite differencing algorithm. For fmincon, 

you don’t specify a single perturbation value, but rather give MATLAB a range, and it uses 
an adaptive algorithm that attempts to find the optimal perturbatin. Units: N/A . 

MaxFunEvals Default: 1000. Options: [Integer > 0]: The MaxFunEvals parameter allows the user to set 
the maximum number of cost function evaluations in an attempt to find an optimal solution. 
This is equivalent to setting the maximum number of passes through an optimization loop 
in a GMAT script. If a solution is not found before the maximum function evaluations, 
fmincon outputs an ExitFlag of zero, and GMAT continues. Units: N/A. 

Maxlter Default: 400. Options: [Integer > 0]: The Maxlter parameter allows the user to set the 

maximum allowable number of optimizer iterations. Depending upon the nature of the 
problem, and whether gradients are provided, it may take many function evaluations for 
each optimizer iteration. The Maxlter parameter allows the user to control the maximum 
function evaluations, and maximum iterations independently. Units: N/A . 

TolX Default: le-4. Options: [Real Number > 0]: The TolX parameter is the termination toler- 

ance on the vector of independent variables, and is used only if the user sets a value. Units: 
N/A. 

TolFun Default: le-4. Options: [Real Number > 0]: The TolFun parameter is the convergence 

tolerance on the cost function value. Units: N/A . 

TolCon Default: le-4 . Options: [Real Number > 0]: The TolCon parameter is the convergence 

tolerance on the constraint functions. Units: N/A . 

Derivative Default: off. Options: [on, off]: If the Deri vat i veChe ck option is set to on, then fmincon 

Check will calculate the gradients of the cost and constraints using finite differncing, and compare 

the values to the values calculated analytically. Units: N/A . 

Diagnostics Default: off. Options: [on, off]: The Diagnostics parameter tells fmincon to output 

general information on the problem by writing diagnostic information to the MATLAB 
prompt. The diagnostic information contains the number of independent variables, the 
number and types of constraints, the sources for derivatives and other information. Units: 
N/A . 

Display Default: iter. Options: [ of f, on, iter, notify, final]: The Display parameter allows the 

user to select between several different options that displays information at the MATLAB 
prompt that indicates the progress of the optimization process. Units: N/A . 

GradObj Default: off. Options: [on, off]: The GradObj parameter allows the user to tell fmincon 

to use finite differencing to calculate the cost function derivative, or to use the cost function 
derivative provided by the user. Units: N/A . 

GradConstr Default: off. Options: [on, off]: The GradConstr parameter allows the user to tell fmin- 
con to use finite differencing to calculate the constraint function derivatives, or to use the 
constraint function derivatives provided by the user. Units: N/A. 



2,5. PLOTS AND REPORTS 


Table 2.11: (Fields Associated with the fmincon 

Solver. . . .continued) 


Field Options and Description 


Table 2.12: Fields Associated with a Differential Corrector 


Field 

Maximumlterations 


ShowProgress 


ReportStyle 


TargeterTextFile 


Options and Description 

Default: 25. Options: [Integer > 0]: The Maximum Iterations field allows the 
user to define the maximum number of iterations taken in attempt to find a 
solution. Units: N/A. 

Default: true. Options: [true, false]: When the ShowProgress field is set to 
true, then data illustrating the progress of the differential correction process 
are written to the status bar. The status bar is updated with information on 
perturbation and iteration passes. . Units: N/A. 

Default: Normal . Options: [Normal, Concise, Verbose, Debug]: The 

ReportStyle field allows the user to control the amount and type of infor- 
mation written to TargeterTextFile. Units: N/A. 

Default: Dif f erentialCorrectorDCAame. Options: [Filename consistent 

with OS]: The TargeterTextFile field allows the user to specify the path and 
file name for the targeter report. Units: N/A. 


UseCentralDif ferences Default: false Options: [true, false]: The UseCentralDif f erences field 

allows the user to choose between one-sided and central differencing for deter- 
mining the Jacobian matrix. If UseCentralDif ferences is set to false, then 
one-sided differencing is used, if UseCentralDif ferences is set to true, then 
central differencing is used. Units: N/A. 


2.5 Plots and Reports 

Tabic 2,13: Fields Associated with OpcnGL Plots 


Field 


Options and Description 


Fields associated with Plot Options 

ShowPlot Default: true. Options: [ true, false]: The ShowPlot field allows the user to 

turn off a plot for a particular run, without deleting the plot object, or removing 
it from the script. If you select true, then the plot will be shown. If you select 
false, then the plot will not be shown. Units: N/A. 
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Table 2.13: (Fields Associated with OpenGL Plots.... continued) 


Field 

Options and Description 

DataCollectFrequency 

Default: 1. Options: [ Integer >1]: The DataCollectFrequency field allows 
the user to define how data is collected for plotting. It is often inefficient to draw 
every ephemeris point associated with a trajectory. Often, drawing a smaller 
subset of the data still results in smooth trajectory plots, while executing more 
quickly. The DataCollectFrequency is an integer that represents how often to 
collect data and store for plotting. If DataCollectFrequency is 10, then Data 
is collected every ten integration steps. Units: Integration Steps 

UpdatePlotFrequency 

Default: 50. Options: [Integer > 1]: The UpdatePlotFrequency field al- 
lows the user to specify how often to update an OpenGL plot is updated 
with new data collected during the process of propagating spacecraft and run- 
ning a mission. Data is collected for a plot according the value defined by 
DataCollectFrequency. An OpenGL plot is updated with the new data, ac- 
cording to the value set in UpdatePlotFrequency. If UpdatePlotFrequency is 
set to 10, then the plot is updated with new data every ten integration steps. 
Units: Integration Steps. 

NumPointsToRedraw 

Default: 0. Options: [Integer > 0]: When NumPointsToRedraw is set to zero, 
all ephemeris points are drawn. When NumPointsToRedraw is set to a positive 
integer, say 10 for example, only the last 10 collected data points are drawn. See 
DataCollectFrequency for explanation of how data is collected for an OpenGL 
plot. Units: Integration Steps. 


Fields associated with Drawing Options 

WireFrame 

Default: Off . Options: [ On, Off ]: When the WireFrame field is set to On, 
celestial bodies are drawn using a wireframe model. When the WireFrame field 
is set to Off, then celestial bodies are drawn using a full map. Units: N/A. 

Solver Iterations 

Default: Off. Options: [On, Off]: The Solverlterations field determines 
whether or not perturbed trajectories are plotted during a solver (Targeter, 
Optimize) sequence. When Solverlterations is set to On, solver iterations 
are shown on the plot. When Solverlterations is Off, the solver iterations 
are not shown on the plot. Units: N/A. 

EclipticPlane 

Default: Off. Options: [On, Off, Note: Only allowed for OpenGL plots with 
Coordinate Systems that use the MJ2000Eq axis system]: The EclipticPlane 
field allows the user to tell GMAT to draw a grid representing the ecliptic plane 
in an OpenGL plot. Note, the ecliptic plane can currently only be drawn for 
plots whose coordinate system uses the MJ2000Eq axis system. Units: N/A . 

XYPlane 

Default: On. Options: [On, Off]: The XYPlane flag allows the user to tell GMAT 
to draw a grid representing the XY-plane of the coordinate system selected 
under the CoordinateSystem field of the OpenGL plot. Units: N/A . 

Axes 

Default: On. Options: [On, Off]: The Axis flag allows the user to tell GMAT to 
draw the Cartesian axis system associated with the coordinate system selected 
under the CoordinateSystem field of an OpenGL plot. Units: N/A . 

Grid 

Default: On. Options: [On, Off]: The Grid flag allows the user to tell GMAT to 
draw a grid representing the longitude and latitude lines celestial bodies added 
to an OpenGL plot. Units: N/A . 



. PLOTS AND REPORTS 


Table 2.13: (Fields Associated with OpenGL Plots.... continued) 


Field 


Options and Description 


EarthSunLines Default: On. Options: [On, Off]: The EarthSunLines allows the user to tell 

GMAT to draw a line that starts at the center of Earth and points towards the 
Sun. Units: N/A . 


Fields Associated with View Definition 


CoordinateSystem Default: EarthMJ2000Eq. Options: [ Any default or user defined coordinate 

system]: The CoordinateSystem field on an OpenGL plot allows the user to 
select which coordinate system to use to draw the plot data. A coordinate 
system is defined as an origin and an axis system, and the CoordinateSystem 
field allows the user to determine the origin and axis system of an OpenGL plot. 
See the CoordinateSystem object fields for information of defining different 
types of coordinate systems. Units: N/A. 

Add Default: DefaultSC, Earth. Options: [SpacecraftName CelestialBodyName 

LibrationPointName BarycenterName]: The Add subfield adds a space- 

craft, celestial body, libration point, or barycenter to a plot. When creating a 
plot the Earth is added as a default body and may be removed by using the Re- 
move command. The user can add a spacecraft, celestial body, libration point, 
or barycenter to a plot by using the name used to create the object. The GUI’s 
Selected field is the equivalent of the script’s Add field. In the event of no Add 
command or no objects in the Selected field, GMAT should run without the 
OpenGL plot and a warning message displayed in the message window. The 
following warning message is sufficient: OpenGL plot will be turned off. 
No object has been selected for plotting. Units: N/A. 

Remove Default: No Default. Options: [Any object included in the Add list ]: The Re- 

move subfield removes a spacecraft, celestial body, libration point, or barycenter 
from a plot. The user can remove any object that has been added to a plot by 
using the name used to add the object. Units: N/A. 


ViewPointReference Default: Earth. Options: [SpacecraftName CelestialBodyName Libration- 

PointName BarycenterName, or a 3- vector of numerical values ]: The 

ViewPointReference field is an optional field that allows the user to 
change the reference point from which ViewPointVector is measured. 
ViewPointReference defaults to the origin of the coordinate system for the 
plot. A ViewPointReference can be any spacecraft, celestial body, libration 
point, or barycenter. Units: N/A. 


ViewPointVector Default: [0 0 30000]. Options: [ SpacecraftName CelestialBodyName Libration- 

PointName BarycenterName, or a 3- vector of numerical values ]: The product 
of ViewScaleFactor and ViewPointVector field determines the view point lo- 
cation with respect to ViewPointReference. ViewPointVector can be a vec- 
tor, or any of the following objects: spacecraft, celestial body, libration point, or 
barycenter. The location of the Viewpoint in three-space is defined as the 
vector addition of ViewPointReference, and the vector defined by product of 
ViewScaleFactor and ViewPointVector in the coordinate system chosen by 
the user. Units: km or N/A. 
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Table 2.13: (Fields Associated with OpenGL Plots.... continued) 


Field Options and Description 

ViewDirection Default: Earth. Options: [ Spacecraft Name CelestialBodyName Libra- 

tionPointName BarycenterName, or a 3- vector of numerical values ]: The 
ViewDirection field allows the user to select the direction of view in an OpenGL 
plot. The user can specify the view direction by choosing an object to point 
at such as a spacecraft, celestial body, libration point, or barycenter. Alterna- 
tively, the user can specify a vector of the form [xyz], If the user specification 
of ViewDirection, ViewPointRef erence, and ViewPointVector, results in a 
zero vector, GMAT uses [0 0 10000] for ViewDirection. Units: km or N/A. 

ViewScaleFactor Default: 1. Options [ Real Number > 0]: The ViewScaleFactor field 

scales ViewPointVector before adding it to ViewPointRef erence. The 
ViewScaleFactor allows the user to back away from an object to fit in the 
field of view. Units: None. 


Fields Associated with View Up Definition 

ViewUpCoordinate Default: EarthMJ2000Eq. Options: [Any default or user defined coordinate 

System system]: The ViewUpCoordinateSystem and ViewUpAxis fields are used to de- 

termine which direction appears as up in an OpenGL plot and together with the 
fields associated the the View Direction, uniquely define the view. The fields 
associated with the View Definition allow the user to define the point of view 
in 3-space, and the direction of the fine of sight. However, this information 
alone is not enough to uniquely define the view. We also must provide how 
the view is oriented about the line of sight. This is accomplished by defining 
what direction should appear as the up direction in the plot and is config- 
ured using the ViewUpCoordinateSystem field and the ViewUpAxis field. The 
ViewUpCoordinateSystem allows the user to select a coordinate system to de- 
fine the up direction. Most of the time this system will be the same as the 
coordinate system chosen under the CoordinateSystem field. Units: N/A. 

ViewUpAxis Default: Z. Options: [X, -X, Y, -Y, Z, -Z]: The ViewUpAxis allows the user to 

define which axis of the ViewUpCoordinateSystem that will appear as the up di- 
rection in an OpenGL plot. See the comments under ViewUpCoordinateSystem 
for more details of fields used to determine the up direction in an OpenGL plot. 
Units: N/A. 


Fields Associated with Field of View 

UselnitialView Default: On. Options: [On, Off]: The UselnitialView field allows the user 

to control the view of an OpenGL plot between multiple rims of a mission 
sequence. The first time a specific OpenGL plot is created, GMAT will auto- 
matically use the view as defined by the fields associated with View Definition, 
View Up Direction, and Field of View. However, if the user changes the view 
using the mouse, GMAT will retain this view upon rerunning the mission if 
UselnitialView is set to false. If UselnitialView is set to true, the view 
for an OpenGL plot will be returned to the view defined by the initial settings. 
Units: N/A. 
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Table 2.13: (Fields Associated with OpenGL Plots.... continued) 


Field 

Options and Description 

PerspectiveMode 

Default: Off. Options: [On, Off]: The PerspectiveMode field allows to 

user to toggle between the Orthogonal or Perspective projections. When 
PerspectiveMode is set to true, the Perspective projection is used. When 
PerspectiveMode is set to false, the Orthogonal projection is used. Units: 
N/A. 

UseFixedFov 

Default: Off. Options: [On, Off]: Units: N/A. 

FixedFovAngle 

Default: 45. Options: [ Real Number > 1]: Units: Degrees. 

Table 2.14: Fields Associated with Report Files 

Field 

Options and Description 

FileName 

Default: /RunReports/ReportFilel . txt. Options: [Valid File Path and 

Name]: The FileName field allows the user to define the file path and file 
name for a report. Units: None. 

Precision 

Default: 16. Options: [Integer > 0]: The Precision field allows the user to set 
the precision of the variable written to a report. Units: Same as variable being 
reported. 

Add 

Default: N/A. Options: [Any user-defined parameter. Ex. Variables, Ar- 
rays, S/C parameters]: The Add field allows a user to add user-defined vari- 
ables to a report file. To add multiple user-defined variables, enclose the 
variables with curly brackets. Ex. MyReportName. Add = {Sat.X, Sat.Y, 
Varl , Array (1,1)}; The GUI’s Selected field is the equivalent of the script’s 
Add field. In the event of no Add command or no objects in the Selected 
field, GMAT should run without the Report output and a warning message 
displayed in the message window. The following warning message is suffi- 
cient: Report plot will be turned off. No object has been selected 
for reporting. Units: N/A. 

WriteReport 

Default: On . Options: [On, Off]: The WriteReport field specifies whether to 
write data to the report FileName. Units: N/A. 

WriteHeaders 

Default: On . Options: [On, Off]: The WriteHeaders field specifies whether to 
include headers that describe the variables in a report. Units: N/A. 

Left Justify 

Default: On. Options: [On, Off]: When the Left Justify field is set to On, then 
the data is left justified and appears at the left most side of the column. If the 
Left Justify field is set to Off, then the data is centered in the column. Units: 
N/A. 

ZeroFill 

Default: On. Options: [On, Off]: Units: N/A . 

ColumnWidth 

Default: 20. Options: [ Integer > 0]: The ColumnWidth field is used to define 
the width of the data columns in a report file. The value for ColumnWidth is 
applied to all columns of data. For example, if ColumnWidth is set to 20, then 
each data column will be 20 white-spaces wide. Units: Characters. 
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Table 2.14: Fields Associated with Report Files.. ..(continued) 


Field 

Options and Description 

Solverlterations 

Default: Off. Options: [On, Off]: The Solverlterations field deter- 

mines whether or not data associated with perturbed trajectories during 
a solver (Targeter, Optimize) sequence is written to a report file. When 
Solverlterations is set to On, solver iterations are written to the report file. 
When Solverlterations is Off, the solver iterations are not written to the 
report file. Units: N/A. 

Table 2.15: Fields Associated with XY-Plots 

Field 

Options and Description 

IndVar 

Default: Def aultSC .AlMod Julian. Options: [Any user variable, array element, 
or spacecraft parameter]: The IndVar field allows the user to define the indepen- 
dent variable for an xy-plot. Only one variable can be defined as an independent 
variable. For example, the line MyXYPlot . IndVar = Def aultSC . AlModJulian 
sets the independent variable to be the epoch of Default SC in the Al time 
system and modified Julian format. Units: N/A. 

Add 

Default: Def aultSC .EarthMJ2000Eq.X. Options: [Any user variable, array ele- 
ment, or spacecraft parameter]:: The Add field allows the user to add dependent 
variables to an xy-plot. All dependent variables are plotted on the y-axis vs the 
independent variable defined by IndVar. To define multiple dependent vari- 
ables, they should be included in curly braces. For example, MyXYPlot. Add 
= {Default SC. EarthMJ2000Eq. Y , Def aultSC .EarthMJ2000Eq. Z] }; . The 
GUI’s Selected field is the equivalent of the script’s Add field. In the event 
of no Add command or no objects in the Selected field, GMAT should run 
without the XYPlot and a warning message displayed in the message window. 
The following warning message is sufficient: XYPlot will be turned off. 
No object has been selected for plotting. Units: N/A. 

Grid 

Default: On . Options: [ On, Off ]: When the Grid field is set to On, then a grid 
is drawn on an xy-plot. When the Grid field is set to Off, then a grid is not 
drawn. Units: N/A. 

Solverlterations 

Default: Off. Options: [On, Off]: The Solverlterations field determines 
whether or not perturbed trajectories are plotted during a solver (Targeter, 
Optimize) sequence. When Solverlterations is set to On, solver iterations 
are shown on the plot. When Solverlterations is set to Off, solver iterations 
are not shown on the plot. Units: N/A. 

ShowPlot 

Default: true. Options: [ true, false]: The ShowPlot field allows the user to 
turn off a plot for a particular run, without deleting the plot object, or removing 
it from the script. If you select true, then the plot will be shown. If you select 
false, then the plot will not be shown. Units: N/A. 


2.6 Solar System, Celestial Bodies and other Space Points 
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Table 2.16: Fields Associated with the Solar System 


Field 

Options and Description 

Ephemer is Source 

Default: DE405. Options: [DE405, DE200, SLP, Analytic]: The 

Ephemeris Source field allows the user to select the source used for planetary 
ephemerides. The source is used globally whenever planetary ephemeris infor- 
mation is required. Units: None. 

Ephemeris 

Updatelnterval 

Default: 0. Options: [ Real Number > 0]. The EphemerisUpdatelnterval is 
used to set how often planetary positions are updated when calculating accel- 
erations during propagation. For low-Earth orbits, EphemerisUpdatelnterval 
can be set to around 60 for faster numerical integration with little ef- 
fect on the accuracy of the propagation. For deep space propagation, 
EphemerisUpdatelnterval should be set to zero. Units: sec. 

U s eTTF orEphemer i s 

Default: false. Options: [ true, false]: GMAT uses time in the TDB system 
as the default time system in the JPL ephemeris files. However, often it is 
possible to use time in the TT time system, without significant difference in 
propagation accuracy. (TT and TDB are within 1 millisecond of each other). 
The advantage to using TT is that it avoids the transformation from TT to TDB 
and therefore orbit propagation will execute faster. The UseTTForEphemeris 
field allows the user to choose between the default of TDB in the ephemeris files 
(UseTTForEphemeris=false), or TT in the ephemeris files (UseTTForEphemeris 
= true). Units: N/A. 

Ephemer is File 

Default: Same as startup file. Options: [ File path and file name consistent 
with operating system ]: The Ephemer isFile field allows the user to specify 
the location and name of the file for each type of ephemeris GMAT supports. 
For example, if Ephemeris is set to DE405, you can set the path for a DE405 
file using SolarSystem.EphemerisFile = c :/MyPath/MyDE405 .f ile. Units: 
N/A. 

AnalyticModel 

Default: LowFidelity. Options: [ LowFidelity]: Units: N/A. 


Table 2.17: Fields Associated with a Libratiou Point 


Field 

Primary 


Secondary 


Point 


Options and Description 

Default: Sun. Options: [ Sun, Mercury, Venus, Earth, Luna, Mars, Jupiter, 
Saturn, Uranus, Neptune, Pluto , or any Barycenter. ( The Primary and Sec- 
ondary bodies cannot be the same )]: The Primary field tells GMAT which body 
to consider the primary body in the calculation of the location of a libration 
point. Units: N/A. 

Default: Earth. Options: [ Sun, Mercury, Venus, Earth, Luna, Maxs, Jupitex, 
Satuxn, Uranus, Neptune, Pluto , or any Barycenter. ( The Primary and 
Secondary bodies cannot be the same )]: The Secondary field tells GMAT 
which body to consider the secondary body in the calculation of the location 
of a libration point. Units: N/A. 

Default: LI. Options: [LI, L2, L3, L4, L5]: The Point field specifies which 
libration point the object corresponds to. Units: N/A. 
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Table 2.18: Fields Associated with a B ary Center 


Field Options and Description 

BodyNames Default: {Earth., Luna}. Options: [ Sun, Mercury, Venus, Earth., Luna, Mars, 

Jupiter, Saturn, Uranus, Neptune, Pluto . (At least one body must be se- 
lected!)]: The BodyNames field is list that contains the bodies used to define 
a barycenter. In a script, the list must be surrounded by curly braces i.e. 
Bar yCenterName .BodyNames = {Earth, Luna} ; Units: N/A. 


Table 2.19: Fields Associated with Celestial Bodies 


Field 


Options and Description 


Mu 


Equatorial Radius 


Flattening 


InitialEpoch 


SMA 


ECC 


INC 


RAAN 


Fields Associated with All Celestial Bodies. ( Using Default Values 
for Earth as an Example) 

Default: 398600.4414. Options: [Real Number > 0]: The Mu field allows the 
user to define the gravitational paramter of a celestial body. Units: km 3 /sec 2 . 

Default: 6378.1363. Options: [Real Number > 0]: The Equator ialRadius field 
allows the user to define the equatorial radius of a celestial body. Units: km. 

Default: 0.00335270. Options: [Real Number]: The Flattening field allows 
the user to define the mass of a celestial body. Units: None. 

Default: 21544.500371. Options: [Real Number ]: The InitialEpoch field 
allows the user to define the initial epoch, in A1 Modified Julian Date, for a 
celestial body. The initial epoch is only used when the user selects Analytic 
for the Ephemeris field on the solar system. In this case, GMAT solves Kepler’s 
problem to determine the position and velocity of a celestial body, using the 
initial epoch and state information described below. Units: AlModJulian. 

Default: 149653978.978377. Options: [Real Number ^ 0]: The SMA field allows 
the user to define the semimajor axis of a celestial body’s orbit about its central 
body. (Only used when the user selects Analytic for the Ephemeris field on 
the Solar System.) Units: km. 

Default: 0.017046. Options: [Real Number > 0]: The ECC field allows the 
user to define the eccentricity of a celestial body’s orbit about its central body. 
(Only used when the user selects Analytic for the Ephemeris field on the Solar 
System.) Units: None. 

Default: 23.439034. Options: [Real Number]: The INC field allows the user to 
define the inclination of a celestial body’s orbit about its central body, in the 
FK5 coordinate system. (Only used when the user selects Analytic for the 
Ephemeris field on the Solar System.) Units: deg. 

Default: 0.000186. Options: [Real Number]: The RAAN field allows the user 
to define the right ascension of the ascending node of a celestial body’s orbit 
about its central body, in the FK5 coordinate system. (Only used when the 
user selects Analytic for the Ephemeris field on the Solar System.) Units: deg. 
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Table 2.19: (Fields Associated with Celestial Bodies.. .continued) 


Field Options and Description 

AOP Default: 101.741639. Options: [Real Number]: The AOP field allows the user 

to define the argument of periapsis of a celestial body’s orbit about its central 
body, in the FK5 coordinate system. (Only used when the user selects Analytic 
for the Ephemeris field on the Solar System.) Units: deg. 

TA Default: 358.127085. Options: [Real Number]: The TA field allows the user 

to define the true anomaly of a celestial body’s orbit about its central body. 
(Only used when the user selects Analytic for the Ephemeris field on the Solar 
System.) Units: deg. 


Special Fields Associated with Earth 

NutationUpdate Default: 60. Options: [Real Number > 0]: The NutationUpdatelnterval 

Interval field, on the Earth Celestial Body, determines how often GMAT updates the 

Nutation matrix used in FK5 reduction. If NutationUpdatelnterval is set to 
zero, the Nutation is updated every time a request is made to calculate the 
orientation of the Earth. If NutationUpdatelnterval is set to a real number 
greater than zero, then GMAT only updates the Nutation matrix if the number 
of seconds defined by NutationUpdatelnterval have elapsed since the last 
request for the Earth’s orientation data. Units: sec. 


Special Fields Associated with Luna 

RotationData Source Default: DE405. Options: [DE405, IAU2002]: The RotationDataSource, on 

the Luna Celestial Body, determines what source GMAT uses to obtain data 
describing the orientation of the moon with respect to the FK5 system. The 
RotationDataSource field is only used for lunar orientation data when calculat- 
ing moon-based coordinate systems with the axes types of Fixed and Equator. 
Units: N/A 


Table 2.20: Fields Associated with a Coordinate System 


Field Options and Description 

Origin Default: Earth. Options: [ Any celestial body, barycenter, libration point, or 

spacecraft]: The Origin field allows the user to select the origin of a coordinate 
system. Units: N/A . 

Axes Default: MJ2000Eq . Options: [ MJ2000Eq, MJ2000Ec, EarthFixed, BodyFixed, 

TOEEq, TOEEc, MOEEq, MOEEc, TODEq, TODEc, MODEq, MODEc, ObjectRef erenced, 
Equator, BodyFixed, BodyInertial,GSE, GSM ]: Units: N/A. 

Primary Default: Earth . Options: [Any celestial body, barycenter, libration point, or 

spacecraft, except the object chosen as in the Secondary field ]: The Primary 
field is only active when Axes is set to ObjectRef erenced. Otherwise, GMAT 
ignores the Primary field. Units: N/A . 
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Table 2.20: (Fields Associated with a Coordinate Sys- 

tem. . .continued) 


Field 

Secondary 


Epoch 


XAxis 


YAxis 


ZAxis 


Updatelnterval 


Options and Description 

Default: Luna . Options: [Any celestial body, bary center, libration point, or 
spacecraft, except the object chosen as in the Primary field]: The Secondary 
field is only active when Axes is set to ObjectRef erenced. Otherwise, GMAT 
ignores the Secondary field. Units: N/A . 

Default: 21545.0. Options: [ Real Number > 0]: The Epoch field is only active 
if the Axes field is defined by an epoch referenced axis system: MOEEq, MOEEc, 
TOEEq, TOEEc. Units: Days . 

Default: R. Options: [ R, -R, V, -V, N, -N]: The X field is only active if the Axes 
field is set to ObjectRef erenced. Otherwise, GMAT ignores the X field. Units: 
N/A. 

Default: No Default. Options: [R, -R, V, -V, N, -N]: The Y field is only active 
if the Axes field is set to ObjectRef erenced. Otherwise, GMAT ignores the Y 
field. Units: N/A. 

Default: N . Options: [R, -R, V, -V, N, -N]: The Z field is only active if the Axes 
field is set to ObjectRef erenced. Otherwise, GMAT ignores the Z field. Units: 
N/A. 

Default: 60. Options: [Real Number > 0]: Units: seconds. 


Table 2.21: Fields Associated with MATLAB Functions 


Field Options and Description 

Default: \matlab\work. Options: [Any valid path for Operating System]: 

Units: N/A. 


FunctionPath 


Chapter 3 


Commands and Events 

3.1 Propagation 


Table 3.1: Propagate Command 


Script Syntax 

Propagate Mode BackProp PropagatorName (SatListl , {StopCondListl}) ... 
BdiCkProipPropagatorName (SatListN, {StopCondListN}) 

Option 

Option Description 

BackProp 

Default: None. Options: [ Backwards or None ]: The BackProp option allows the 
user to set the flag to enable or disable backwards propagation for all spacecraft in 
the the SatListN option. The Backward Propagation GUI check box field stores 
all the data in BackProp. A check indicates backward propagation is enabled and 
no check indicates forward propagation. In the script, BackProp can be the word 
Backwards for backward propagation or blank for forward propagation. Units: N/A. 

Mode 

Default: None. Options: [ Synchronized or None ]: The Mode option allows the 
user to set the propagation mode for the propagator that will affect all of the 
spacecraft added to the SatListN option. For example, if synchronized is selected, 
all spacecraft are propagated at the same step size. The Propagate Mode GUI field 
stores all the data in Mode. In the script, Mode is left blank for the None option 
and the text of the other options available is used for their respective modes. Units: 
N/A. 

PropagatorN ame 

Default: DefaultProp. Options: [ Default propagator or any user-defined propaga- 
tor ]: The PropagatorName option allows the user to select a user defined propagator 
to use in spacecraft and/or formation propagation. The Propagator GUI field stores 
all the data in PropagatorName. Units: N/A. 

SatListN 

Default: Defaults C. Options: [ Any existing spacecraft or formations, not being 
propagated by another propagator in the same Propagate event. Multiple spacecraft 
must be expressed in a comma delimited list format. ]: The SatListN option allows 
the user to enter all the satellites and/or formations they want to propagate using 
the PropagatorName propagator settings. The Spacecraft List GUI field stores all 
the data in SatListN. Units: N/A. 
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Table 3.1: Propagate Command . . .continued 


StopCondListN 

/Parameter 


StopCondListN 

/Condition 


Default: DefaultSC.ElapsedSecs =. Options: [ Any single element user accessi- 
ble spacecraft parameter followed by an equal sign ]. The StopCondListN option 
allows the user to enter all the parameters used for the propagator stopping condi- 
tion. See the StopCondListN/Condition Option/Field for additional details to the 
StopCondListN option. Units: N/A. 

Default: 8640.0. Options: [ Real Number, Array element, Variable, spacecraft 
parameter, or any user defined parameter ]. The StopCondListN option allows 
the user to enter the propagator stopping condition’s value for the StopCondListN 
Parameter field. Units: Dependant on the condition selected. 


Script Examples 

% Single spacecraft propagation with one stopping condition 
% Syntax #1 

Propagate DefaultPr op (Default SC, {DefaultSC.ElapsedSecs = 8640.0}); 

% Single spacecraft propagation with one stopping condition 
% Syntax #2 

Propagate DefaultPr op (Default SC) {DefaultSC.ElapsedSecs = 8640.0}; 

% Single spacecraft propagation by one integration step 
Propagate DefaultPr op (Default SC) ; 

% Multiple spacecraft propagation by one integration step 
Propagate Def ault Prop (Sat 1 , Sat2, Sat3) ; 

% Single formation propagation by one integration step 
Propagate Def aultProp(Def aultFormation) ; 

% Single spacecraft backwards propagation by one integration step 
Propagate Backwards Def aultProp (Def aultSC) ; 

% Two spacecraft synchronized propagation with one stopping condition 

Propagate Synchronized Def aultProp (Sat 1 , Sat2, {DefaultSC.ElapsedSecs = 8640.0}); 

% Multiple spacecraft propagation with multiple stopping conditions and propagation settings 
% Syntax #1 

Propagate Propl (Satl , Sat2 , {Satl . ElapsedSecs = 8640.0, Sat2.MA = 90}) ... 
Prop2(Sat3, {Sat3.TA =0.0}); 

% Multiple spacecraft propagation with multiple stopping conditions and propagation settings 
% Syntax #2 

Propagate Propl (Satl , Sat2) {Satl .ElapsedSecs = 8640.0, Sat2.MA = 90} ... 
Prop2(Sat3) {Sat3.TA = 0.0}; 



3.2. CONTROL FLOW 

3.2 Control Flow 


Table 3.2: If Command 


Script Syntax 

If <logical expression 
<Statements>; 

Endlf ; 

( Simple If statement) 

If <logical expression 
<Statements>; 

Endlf ; 

( Compound If statement) 

> I <logical expression & clogical expression; 

(If- Else i statement ) 

If <logical expression; 

<Statements>; 

Else; 

<Statements>; 

Endlf ; 

Option 

Option Description 

<logical expression 

Default: DefaultSC.ElapsedDays < 1.0. Options: [ Argl < Arg2 and < can 
be >,<,>=,<=,==, ]. Argl and Arg2 can be any of the following: Real 

Number, Array element. Variable, Spacecraft Parameter or any other user de- 
fined parameter. Units: N/A. 

<Statements> 

Default: N/A. Options: [ Any script line that can be in the mission sequence ]. 
Units: N/A. 

i 

Default: N/A. Options: [N/A]. The | option allows the user to set an OR oper- 
ator in between <logical expressions. Units: N/A. 

& 

Default: N/A. Options: [N/A]. The I option allows the user to set an AND 
operator in between <logical expressions. Units: N/A. 

Script Examples 


If DefaultSC.ElapsedDays < 1; 

Propagate DefaultProp( Default SC , { DefaultSC.ElapsedDays = 0.01 }); 
Endlf; 


If MyVariable < MyArray (1 , 1) ; 

MyArray(l,l) = 5; 

Endlf; 

If Def aultSC. Earth. TA < MyArray (1 ,2) ; 

Propagate DefaultProp( DefaultSC ); 
Endlf; 
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Table 3.3: While Command 


Script Syntax 


(Simple While Loop) 

While <logical expression> ; 

<Statements>; 

EndWhile ; 

(Compound While Loop) 

While <logical expression> I <logical expression> & <logical expression> 
<Statements> 

EndWhile 


Option Option Description 

<logical expression> Default: Default SC .ElapsedDays < 1.0. Options:[ Argl < Arg2 and < can be 
>, <, >=, <=, ==, ]. Argl and Arg2 can be any of the following: Real Number, 

Array, Variable, Spacecraft Parameter or any other user defined parameter. Units: 
N/A. 

<Statements> Default: N/A. Options: [ Any script line that can be in the mission sequence ]. 

Units: N/A. 

I Default: N/A. Options: [N/A] . The | option allows the user to set an OR operator 

in between <logical expressions. Units: N/A. 

& Default: N/A. Options: [N/A] . The I option allows the user to set an AND operator 

in between <logical expressions. Units: N/A. 


Script Examples 

While Default SC. ElapsedDays < 1; 

Propagate DefaultProp( DefaultSC , { Default SC .ElapsedDays = 0.01 }); 
EndWhile; 

While MyVariable < MyArray (1 , 1) ; 

MyArray(l,l) = 5: 

EndWhile; 


3.2. CONTROL FLOW 


Table 3.4: For Command 


Script Syntax 


(. Simple For Loop) 

For Variable = Start :End; 

<Statements> ; 

EndFor ; 


(Expanded For Loop) 

For Variable - Start : Increment : End; 

<Statements> ; 

EndFor; 


Command Description 


The for loop is a control flow statement that allows portions of code to be executed iteratively using an 
explicit loop variable (Wikipedia). GMAT for loops are three-expression loops that allow the user to set 
the initial value of the loop variable, its increment, and the test to exit the loop. A parameter must be 
defined explicitly using a Create Variable statement or GUI equivalent before it can be used in a for loop 
command statement. The only parameter type that can be used as a loop variable is the variable type. 
The parameters used to define Start, Increment, and End can be any of the following GMAT parameters: 
integer?? (real), variable, array element, spacecraft property. 

GMAT allows the for loop variable to be changed inside the loop by the user, and the resulting behavior of 
the for loop is equivalent to the behavior defined in ANSI C. If a change is made to the loop variable inside 
of the loop, if this change causes the exit test to be violated, GMAT will exit the for loop. 


Option 

Option Description 

Variable 

Default: No Default. Options: [ Variable ]: The Variable option allows the user to 
define the variable that will store the For Loop numeric range. Units: N/A. 

Start 

Default: 1. Options: [ Real Number, Array element, Variable, or any user defined 
parameter ]. The Start option allows the user to set the starting numeric range 
value of the For Loop. Start can be equal to End, but the For Loop will not execute. 
Units: N/A. 

Increment 

Default: 1. Options: [ Real Number, Array element, Variable, or any user de- 
fined parameter ]. The Increment option allows the user to set the numeric range 
increment value of the For Loop. When the Increment option is left out of the 
script syntax the default value is used. If an Increment value of 0 is used, the 
For Loop should not execute but GMAT should continue to run. If End>Start 
and Increment < 0, then the For Loop should not execute. If Start>End and 
Increment > 0, then the For Loop should not execute. Units: N/A. 

End 

Default: 10. Options: [ Real Number, Array, Variable, or any user defined param- 
eter ] . The End option allows the user to set the ending numeric range value of the 
For Loop. End can be equal to Start, but the For Loop will not execute. Units: 
N/A. 

Script Examples 

% Output the value of the For loop Variable to a file 
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Table 3.4: For Command . . . continued 


For I = 1:1:10; 

GMAT testVar = I; 

Report DefaultReportFile I; 
EndFor ; 


SOLVER-RELATED 


3.3 Solver-related 


Table 3.5: Target Command 


Script Syntax 

Target SolverName ; 

<Statements> 
EndTarget ; 

Option 

Option Description 

SolverName 

Default: DefaultDC. Options: [ Any differential corrector existing in the resource 
tree or created in the script ]: The SolverName option allows the user to choose 
between any previously created differential correctors for use in a targeting sequence. 
For example, to begin a targeting sequence using DefaultDC, the script is Target 
DefaultDC. Units: N/A. 

<Statements> 

Default: None. Options: [ Any non-targeter and non-optimizer command lines used 
in the mission sequence, as well as the targeter dependent command lines Achieve 
and Vary.]: Units: N/A. 

Script Examples 

% Beginning and ending syntax for the Target command 
Target DefaultDC; 

EndTarget ; 




Table 3.6: Optimize Command 


Script Syntax 

Optimize SolverName; 

<Statements> 
EndOptimize ; 


Option 

Option Description 

SolverName 

Default: DefaultSQP. Options: [ Any existing optimizer ]: The SolverName field 
allows the user to choose between any previously created optimizer for use in 
an optimization sequence. For example, to begin a optimization sequence using 
DefaultSQP, the script is Optimize DefaultSQP. Units: N/A. 

< Statements 

Default: None. Options: [ Any non-targeter and non-optimizer command lines used 
in the mission sequence, as well as the optimizer dependent command lines Vary, 
NonLinearConstraint, and Minimize. ]: Units: N/A. 


Script Examples 


% Beginning and ending syntax for the Optimize command 
Optimize DefaultDC; 
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Table 3.6: Optimize Command . . . continued 


EndOptimize ; 


Table 3.7: Achieve Command 


Script Syntax: Achieve So l verName (Goal = Argl, {Tolerance = Arg2}) ; 


Option Option Description 

Goal Default: DefaultSC.Earth.RMAG. Options: [ Spacecraft parameter, Array element, 

Variable, or any other single element user defined parameter, excluding numbers ]: 
The Goal option allows the user to select any single element user defined parameter, 
except a number, to Achieve. 

Argl Default: 42165. Options: [ Real Number, Array element, Variable, or any user 

defined parameter that obeys the conditions of Chapter ?? for the selected Goal ] 
The Argl option is the desired value for Goal after the solver has converged. Units: 
N/A. 

Tolerance Default: 0.1. Options: [ Real Number, Array element, Variable, or any user de- 

fined parameter > 0 ]: The Tolerance option sets Arg2. Arg2 is the convergence 
tolerance for Argl. Units: N/A. 

SolverName Default: DefaultDC. Options: [ Any user defined differential corrector ]: The Solver- 

Name option allows the user to choose which solver to assign to the Achieve com- 
mand. Units: N/A. 

Script Examples 

Achieve DefaultDC(DefaultSC.Earth.RMAG = 42165.0, {Tolerance = 0.1}); 


Table 3.8: Vary Command 


3.3 . SOLVER-RELATED 


Scripts yntax 


Vary SolverName (Variable = Initial Guess, {Perturbation = Argl,MaxStep = Arg2, Lower = Arg3, 
... Upper = Arg4, AdditiveScaleFactor = Arg5, MulitiplicativeScaleFactor = Arg6}) 


Option Option Description 


Parameters Associated with All Solvers. 

SolverName Default: DefaultDC. Options: [ Any user defined solver ]: The SolverName option 

allows the user to choose which solver to assign to the vary command. Units: N/A. 

Variable Default: DefaultIB.V. Options: [ Spacecraft parameter, Array element, Variable, or 

any other single element user defined parameter, excluding numbers ] The Variable 
option allows the user to select any single element user defined parameter, except 
a number, to vary. For example, DefaultIB.V, DefaultIB.N, DefaultIB. Element!., 
DefaultSC.TA, Array (1,1), and Variable are all valid values. The three element 
burn vector or multidimensional Arrays are not valid values. Units: N/A. 
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Table 3.8: Vary Command . . . continued 


InitialGuess 

Default: 0.5. Options: [ Real Number, Array element, Variable, or any user defined 
parameter that obeys the conditions of Chapter ?? for the selected Variable ]: The 
InitialGuess option allows the user to set the initial guess for the selected Variable. 
Units: km/s. 

Lower 

Default: 0.0 . Options: [ Real Number, Array element, Variable, or any user defined 
parameter (Upper > Lower ) ]: The Lower option allows the user to set Arg3 to the 
lower bound of the quantity being varied. Units: N/A. 

Upper 

Default: 3.14159 . Options: [ Real Number, Array element, Variable, or any user 
defined parameter (Upper > Lower ) ]: The Upper option allows the user to set 
Arg4 to the upper bound of the quantity being varied. Units: N/A. 


Parameters Associated with Differential Corrector. 

Perturbation 

Default: le-4 . Options: [ Real Number, Array element, Variable, or any user 
defined parameter > 0 ]: The Perturbation option is set by specifying a value for 
Argl. The value of Argl is the perturbation size in calculating the finite difference 
derivative. Units: N/A. 

MaxStep 

Default: 0.2 . Options: [ Real Number, Array element, Variable, or any user defined 
parameter > 0 ]: The MaxStep option is set by specifying a value for Arg2. The 
value of Arg2 limits the size of the step taken during an interaction of the differential 
corrector. Units: N/A. 


Parameters Associated with fmincon Optimizer. 

Additive Scale 
Factor 

Default: 0 . Options: [ Real Number, Array element, Variable, or any user defined 
parameter ]: The AdditiveScaleFactor Field is used to nondimensionalize the 
independent variable, fmincon sees only the nondimensional form of the variable. 
The nondimensionalization is performed using the following equation: x n = {xd — 
a)/m . ( x n is the non-dimensional parameter. Xd is the dimensional parameter. 
a — additive scale factor, m = multiplicative scale factor.) Units: N/A. 

Multiplicative Scale 
Factor 

Default: 1.0 . Options: [ Real Number, Array element, Variable, or any user 
defined parameter ]: The MultiplicativeScaleFactor Field is used to nondimen- 
sionalize the independent variable, fmincon sees only the nondimensional form of 
the variable. The nondimensionalization is performed using the following equation: 
x n = (xd — a)/ m . (x n is the non-dimensional parameter. Xd is the dimensional 
parameter, a — additive scale factor, m — multiplicative scale factor.) Units: N/A. 

Script Examples 

% Impulsive Burn Vary Command 

Vary DefaultDC(DefaultIB . V = 0.5, {Perturbation = 0.0001, MaxStep =0.2, ... 
Lower = 0, Upper = 3.14159}); 


Table 3.9: Minimize Command 




. SOLVER-RELATED 
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Script Syntax: Minimize Optimizer Name (Arg) 


CHAPTER 'S : COMMANDS AND EVENTS 

Table 3.9: Minimize Command . . . continued 


Option 

Option Description 

Optimizer Name 

Default: SQP1. Options: [ Any existing fmincon solver ]: The OptimizerName option 
allows the user to specify which solver to use to minimize the cost function. Units: 
N/A. 

Arg 

Default: Default SC .ECC. Options: [ Variable, Spacecraft parameter, or Array ele- 
ment]. The Arg field allows the user to specify the function to be minimized upon 
convergence of the solver given by OptimizerName. Arg can be any of the following: 
Variable, Array element, or Spacecraft Parameter or any other lxl numeric user 
defined parameter. Units: N/A. 


Script Examples 


% Minimize the eccentricity of Sat, using fminconSQP 
Minimize fminconSQP (Sat . ECC) ; 


% Minimize the Variable DeltaV, using fminconSQP 
Minimize fminconSQP (DeltaV) ; 

% Minimize the first component of MyArray, using fminconSQP 
Minimize fminconSQP (MyArray (1,1)); 


. SOLVER-RELATED 


Table 3.10: NonLinearConstraint Command 


Script Syntax: NonLinearConstraint Optimizer Name (<logical expression>) 


Option Option Description 

OptimizerName Default: SQP1. Options: [ Any existing fmincon solver ]: The OptimizerName option 

allows the user to specify which solver to use in satisfying nonlinear constraints. 
Units: N/A. 

clogical expression> Default: Def aultSC .SMA = 7000. Options:[ Argl < Arg2 where < can be >= 

]. The logical expression field allows the user to specify the constraint to 
be satisfied upon convergence of the solver given by OptimizerName. Argl and 
Arg2 can be any of the following: Real Number, a 1-D Array (column vector), 
Array element, Variable, Spacecraft Parameter or any other numeric user defined 
parameter. If Argl is a 1-D Array, then Arg2 must be a 1-D Array with the same 
dimensions and vice-versa. Units: N/A. 


Script Examples 

% Constrain the SMA of Sat to be 7000 km, using fminconSQP 
NonLinearConstraint fminconSQP( Sat. SMA = 7000 ); 

% Constrain the SMA of Sat to be less than or equal to 7000 km, using fminconSQP 
NonLinearConstraint fminconSQP ( Sat. SMA <= 7000 ); 

% Constrain the SMA of Sat to be greater than or equal to 7000 km, using fminconSQP 
NonLinearConstraint fminconSQP ( Sat. SMA >= 7000a ); 
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3 . 4 Miscellaneous 


Table 3.11: Maneuver Command 


Script Syntax: Maneuver BurnName (Space era ftName) ; 


Option Option Description 

BurnName Default: Default IB. Options: [ Any impulsive burn existing in the resource tree or 

created in the script]: The BurnName field allows the user to choose between any 
previously created impulsive burn. As an example, to maneuver Default SC us- 
ing DefaultIB, the script line would appear as Manevuer Def ault IB (Default SC) . 
Units: N/A. 

SpacecraftName Default: Def ault SC. Options: [ Any spacecraft existing in the resource tree or cre- 

ated in the script]: The SpacecraftName field allows the user to select which space- 
craft to maneuver using the maneuver selected in the BurnName field. 

Units: N/A. 

Script Examples 

% Impulsive Burn 

Maneuver DefaultIB (Def aultSC) ; 


Table 3.12: BeginF initeBurn Command 


Script Syntax: BeginFiniteBum ManeuverName (SpacecraftName) ; 

Option Option Description 

ManeuverName Default: DefaultFB. Options: [ Any finite burn existing in the resource tree or cre- 

ated in the script]: The ManeuverName option allows the user to choose between 
any previously created finite burn. As an example, to maneuver Def ault SC us- 
ing DefaultFB, the script line would appear as Manevuer DefaultFB (Def ault SC) . 
Units: N/A. 

SpacecraftName Default: Def aultSC. Options: [ Any spacecraft existing in the resource tree or cre- 

ated in the script]: The SpacecraftName option allows the user to select which 
spacecraft to maneuver using the maneuver selected in the ManeuverName option. 
Units: N/A. 

Script Examples 

% Default BeginFiniteBum syntax 
BeginFiniteBum Def ault FB (Def aultSC) ; 


Table 3.13: EndFiniieBurn Commanx: 



A. MISCELLANEOUS 


Script Syntax: EndFiniteBum ManeuverName (SpacecraftName) ; 


Option Option Description 

ManeuverName Default: DefaultFB. Options: [ Any finite burn existing in the resource tree or cre- 

ated in the script]: The ManeuverName option allows the user to choose between 
any previously created finite burn. As an example, to maneuver Default SC us- 
ing DefaultFB, the script line would appear as Manevuer DefaultFB (DefaultSC) . 
Units: N/A. 

SpacecraftName Default: DefaultSC. Options: [ Any spacecraft existing in the resource tree or cre- 

ated in the script]: The SpacecraftName option allows the user to select which 
spacecraft to maneuver using the maneuver selected in the ManeuverName option. 
Units: N/A. 


Script Examples 

% Default EndFiniteBum syntax 
EndFiniteBum DefaultFB (DefaultSC) ; 


Table 3.14: CallFunction Command 


Script Syntax 


Function call with Inputs and Outputs 
GMAT [OutputList] = Function (InputList) 

Function call with Outputs only 
GMAT [OutputList] = Function 

Function call with Inputs only 
GMAT Function (InputList) 

Function call with no Inputs or Outputs 
GMAT Function 


Option 

OutputList 


InputList 


Function 


Option Description 

Default: None. Options: [ Variables, Arrays, S/C Paramters, any other user-defined 
parameters, or blank. Multiple outputs must be expressed in a comma delimited 
list format ]: The OutputList option allows the user to set the output of Function 
to a user defined parameter. Units: N/A. 

Default: None. Options: [ Variables, Arrays, S/C Paramters, any other user-defined 
parameters, or blank. Multiple inputs must be expressed in a comma delimited list 
format. ]: The InputList option allows the user to set the input of Function to a 
user defined parameter. Units: N/A. 

Default: None. Options: [ GMAT of Matlab Function ]: The Function option allows 
the user to set the function that will be called in a specific location of the mission 
sequence. The function has to be defined before it can be used in the CallFunction 
Command. Units: N/A. 


Script Examples 




chapter s: commands and events 

Table 3.14: CallFunction Command . . .continued 


% Matlab function call without inputs or outputs 
% Syntax 1 
GMAT clear All; 

% Matlab function call without inputs or outputs 
% Syntax 2 

GMAT [ ] - clear All ( ); 


Table 3.15: Toggle Command 

Script Syntax: Toggle 

Ou tpu tNam es Arg 

Option 

Option Description 

OutputNames 

Default: DefaultOpenGL . Options: [ Any OpenGL, Report, XYplot, or any other 
Plot/Report type ]: The Toggle option allows the user to assign the Plot/Report(s) 
to be toggled. When more than one Plot/Report is being toggled they need to be 
separated by a space. Units: N/A. 

Arg 

Default: On. Options: [ On or Off ]: The Arg option allows the user to turn off or 
on the data output to a Plot/Report. Units: N/A. 

Script Examples 

% Turn off Report file for the first day of propagation 
Toggle ReportFilel Off 


Propagate Default Prop (Default SC, DefaultSC.ElapsedDays = 1); 
Toggle Report Fi lei On 

Propagate DefaultPr op (Default SC, DefaultSC.ElapsedDays = 1); 

% Turn off XYPlot and Report file for the first day of propagation 
Toggle XYPlot 1 ReportFilel Off 

Propagate DefaultPr op (Default SC, DefaultSC.ElapsedDays = 1) ; 
Toggle XYPlot 1 ReportFilel On 

Propagate DefaultProp (Default SC, DefaultSC.ElapsedDays = 1); 


Table 3.16: Report Command 


A. MISCELLANEOUS 


Script Syntax: Report ReportName DataList 


Option Option Description 

ReportName Default: N/A. Options: [ Any ReportFile created ]: The ReportName option allows 

the user to specify the ReportFile for data output. Units: N/A. 

DataList Default: N/A. Options: [ Spacecraft parameter, Array, Variable, String, or any other 

single user defined parameter ]: The DataList option allows the user to output 
data to the Filename specified by the ReportName . Multiple objects can be in the 
DataList when they are separated by spaces. Units: N/A. 
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Table 3.16: Report Command .. .continued 


Script Examples 

% Report the time and position of Default SC 

Report DefaultReport Def aultSC . AlModJulian DefaultSC.X DefaultSC.Y DefaultSC.Z; 


Table 3.17: Script Event Command 


Script Syntax 


BeginScript ; 

<Statements>; 

EndScript ; 

Option Option Description 

<Statements> Default: N/A. Options: [ Any valid line of GMAT script ]. Units: N/A. 


Script Examples 

% Assignment command inside Script Event 
BeginScript ; 

GMAT testVar = 24; 

EndScript ; 


Table 3.18: Pause Command 


Script Syntax: Pause 


Command Description 

The Pause command allows the user to pause a running GMAT script. 


Script Examples 

% Pause between propagation sequences 

Propagate Def aultProp (Def aultSC) Def aultSC . ElapsedSecs = 8640.0; 
Pause ; 

Propagate Def aultProp (Def aultSC) Def aultSC . ElapsedDays = 10.0; 


Table 3.19: Stop Command 


Script Syntax: Stop 


Command Description 

The Stop command allows the user to stop a running GMAT script. 


Script Examples 

% Stop between propagation sequences 

Propagate Def aultProp (Def aultSC) Def aultSC . ElapsedSecs = 8640.0; 
Stop; 





.4. MISCELLANEOUS 


Table 3.19: Stop Command . . .continued 


Propagate Default Prop (Default SC) DefaultSC.ElapsedDays = 10.0; 


Table 3.20: Save Command 


Script Syntax: Save ObjectList 


Option Option Description 

ObjectList Default: DefaultSC. Options: [ Any user-defined objects, excluding variables and 

arrays ]: The ObjectList option allows the user to save the properties of the 
objects selected to the output path. Multiple objects can be in the ObjectList 
when they are separated by spaces. Units: N/A. 


Script Examples 

% Save DefaultSC data after a 1 day propagation 

Propagate DefaultProp (DefaultSC, DefaultSC.ElapsedDays = 1); 
Save DefaultSC; 

% Save Impulsive Burn and DefaultSC data after a Targeter sequence 
EndTarget ; 

Save Default IB DefaultSC; 


Index 


AAttitudeRateStateType, 35 
AOP, 13, 31, 55 
AZI, 14, 32 
Accuracy, 21, 42 
Add, 49, 51, 52 
AnalyticModel, 53 
AngularVelocityX, 36 
AngularVelocityY, 36 
AngularVelocityZ, 36 
Anomaly Type, 12, 30 
AttitudeCoordinateSystem, 35 
AttitudeMode, 35 
AttitudeStateType, 35 
Axes, 44, 45, 48, 55 
Axis, 37 

Backwards Propagation, 57 
BeginFiniteBum, 70 
BodyNames, 54 
BurnS caleFact or, 45 
CallFunction, 71 
Cd, 16, 34 

CentralBody, 18, 40 

ColumnWidth., 51 

CoordinateSystem, 11, 29, 49 

Cr, 16, 34 

DCM11, 36 

DCM12, 36 

DCM33, 36 

DECV, 15, 33 

DEC, 14, 32 

DataCollectFrequency, 48 
DateFormat, 12, 30 
Degree, 19, 40 
DerivativeCheck, 46 
Diagnostics, 46 
Dif fMaxChange, 46 
Dif fMinChange, 46 
Display, 46 

Drag. AtmosphereModel, 20, 41 

Drag.F107A, 20, 41 

Drag.F107, 20, 41 

Drag. Magnetic Index, 20, 41 

DragArea, 16, 34 

Drag, 19, 41 

DrawWireFrame, 48 

DryMass, 16, 34 

EA, 13, 31 

ECC, 13, 31, 54 


EarthSunLines, 49 
EclipticPlane, 48 
EndFiniteBurn, 71 
EphemerisFile, 53 
EphemerisUpdatelnterval, 53 
Ephemeris, 53 
Epoch., 12, 30, 56 
EquatorialRadius, 54 
ErrorControl, 20, 42 
Euler Angle 1, 35 
EulerAngle2, 35 
Euler Angle3, 35 
EulerAngleRatel, 36 
EulerAngleSequence, 35 
FPA, 14, 32 
FileName, 51 
FixedFovAngle, 51 
Flattening, 54 
For, 61 

FuelDensity, 37 
FuelMass, 37 
FunctionPath, 56 
GradConstr, 46 

Gravity .PrimaryBody. Degree, 19, 40 

Gravity .PrimaryBody .Model, 19, 40 

Gravity .PrimaryBody .Order, 19, 40 

Grid, 48, 52 

HA, 13, 31 

INC, 13, 31, 54 

If, 59 

IndVar, 52 

Initial Value, 66 

InitialEpoch, 54 

InitialStepSize, 21, 42 

Integrators 

Script Fields, 21, 42 
LeftJustify, 51 
Libration Point, 53 
Lower, 66 
MA, 13, 31 
Maneuver, 70 
MaxFunEvals, 46 
Maxlter, 46 

MaxStep At tempts, 21, 43 
MaxStep, 21, 42, 66 
Maximum Iterations, 47 
MeanLongitude, 15, 33 
MinlntegrationError, 21, 43 


76 



INDEX 


MinStep, 21, 42 
Minimize, 66 

MultiplicativeScaleFactor, 66 
Mn, 54 

NomlntegrationError, 22, 43 
NonLineaxConstraint, 69 
NumPointsToRedraw, 48 
NntationUpdatelnterval, 55 
Optimize, 63 
Order, 19, 40 
Origin, 37, 44, 45, 55 
Pause, 74 

PerspectiveMode, 51 
Perturbation, 66 
PointMasses, 20, 41 
Point, 53 
Precision, 51 
PressnreRegnlated, 37 
Pressure, 37 
PrimaryBodies, 19, 40 
Primary, 53, 55 
Propagation Mode, 57 
RAAN, 13, 31, 54 
RAV, 15, 33 
RA, 14, 32 
RMAG, 14, 32 
RadApo, 13, 31 
RadPer, 14, 32 
Ref Temperature, 37 
Remove, 49 
ReportStyle, 47 
Report, 72 

RotationDataSource, 55 
SMA, 13, 31, 54 
SRPArea, 16, 34 
SRP, 20, 41 
Save, 75 

ScriptEvent, 74 
Secondary, 53, 56 
ShowPlot, 47, 52 
ShowProgress, 47 
Solar System 

Script Fields, 53 
Solverlterations, 48, 52 
StateType, 11, 29 
Stop, 74 
TA, 13, 31, 55 
Tank, 38 

TargeterTextFile, 47 
Target, 63 
Temperature, 37 
ThrnstS caleFact or, 38 
Thrusters, 45 
Toggle, 72 
TolCon, 46 
TolFnn, 46 
TolX, 46 


Tolerance, 64 
Type, 21, 42 
Update Interval, 56 
UpdatePlotFrequency, 48 
Upper, 66 

UseCentralDif ferences, 47 
UseFixedFov, 51 
UselnitialView, 50 
UseTTForEphemeris, 53 
VMAG, 14, 32 

VX, 12, 30 

VY, 12, 30 

VZ, 12, 30 
VectorFormat, 44 
ViewDirection, 50 
ViewPointRef erence, 49 
ViewPointVector, 49 
ViewScaleFactor, 50 
ViewUpAxis, 50 
ViewUpCoordinateSystem, 50 
Volume, 37 

While, 60 
WriteHeaders, 51 
XYPlane, 48 

X.Direction, 37 

X, 12, 30, 56 
Y_Direction, 38 

Y, 12, 30, 56 
Z_Direction, 38 
ZeroFill, 51 

Z, 12, 30, 56 
h, 15, 33 

k, 15, 33 

p, 15, 33 
ql, 36 
q2, 36 
q3, 36 
q4, 36 

q, 15, 33 



